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PREFACE 


The UNIX* operating system is a large (for a microcomputer) task-oriented system that 
allows the user to make full use of any combination of the system’s software tools to attain 
a desired effect. It is composed of a tree-based file structure supporting a large, unparti- 
tioned root file system which contains literally hundreds of files, programs, and utilities that 
can be manipulated in combination to produce countless elfects. 


The power and complexity of UNIX and the Plexus P/35 dictates that using the system 
often requires foresight and consideration for the impact that a given procedure may have 
on the overall system. This means that: 


® Each user should have an available reference to functions that can create an impact on 
the overall system and, 


* Some one person must be appointed to take overall responsibility to ensure the sound- 
ness of the P/35 and its UNIX operating system. This person is known as the system 
administrator. 


This User’s Manual has been written to answer both of those needs — to provide pro- 
cedures and considerations for operations that alfect the soundness of the overall system, 
whether they are tasks performed by an ambitious user or duties performed by the system 
administrator. Below is a chapter-by-chapter description of what this manual contains: 


Chapter One, Equipment Overview, describes the physical aspects of the P/35, basic design 
characteristics, and location of the controls. 


Chapter Two, Startup, Shutdown, and Tape Drive Operation, tells you how to turn the sys- 
tem on, boot it up, and log in as a user. 


Chapter Three, System Administration Considerations, lends insight and advice on the fac- 
tors you must consider for your system and its specific use. Systems as complex as the P/35 
generally require a system administrator. 


UNIX is a trademark of AT&T Bell Laboratories. 
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Chapter Four tells how to set up a system lor multi-user applications. It fills in the gap 
between plugging the computer in and supporting a group of interactive users. 


Chapter Five provides a ready reference for moving your system back and forth among the 
four initialization states available as shipped from Plexus. 


Chapters Six, Seven, and Eight cover the soitware configuration considerations when you 
expand your system by adding users, printers, or disk space. 


Chapters Nine and Ten provide practical guidelines on using two of UNIX’ more powerlul 
tools; SCCS. the Source Code Control System that tracks multiple versions of a program or 
document; and UUCP, the UNIX to UNIX Communication Protocol that supports batch 
operations among UNIX computers. either via phone lines or hardwiring. 


Chapter Eleven, The Standalone Environment, describes the programs created by and 
shipped from Plexus that are designed to maintain and/or modify your software and 
hardware interlaces. 


Chapter I'welve covers the daily, weekly, and monthly routines you must observe to keep 
your system backed up and running smoothly. 


Chapter 13, Crisis Recovery, provides procedures for minimizing the consequences of sys- 
tem crashes, and for identifying problems as they occur. 


Finally, this manual provides an appendix, Hardware/Firmware Diagnostics, that provides 
you with more information as to what could specilically be wrong if your system refuses to 
boot properly. The information here is designed to give you a better understanding of our 
equipment and to make any encounters with Plexus Field Service as informative and elfi- 
cient as possible. 
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Chapter One 


EQUIPMENT OVERVIEW 


The P/35 is Plexus Computers’ powerful desktop mini. It features a Motorola 68000 
microprocessor, distributed intelligent input/output (I/O) control and an industry-standard 
Multibus* backplane. It runs the UNIX** operating system and ts available in 8-user and 
16-user versions. 


The P/35 is enclosed in a desktop-sized cabinet which contains a tape drive, a rigid-disk 
drive, a card cage with printed circuit (PC) boards, and power supplies. There is an I/O 
panel on the back, and a reset/power keyswitch on the front. The card cage contains a 
68000-based processor board, one or two intelligent communication processors (ICPs), one 
or two memory array boards, and a disk and tape controller. These controller boards plug 
into a six-slot Multibus backplane. 


1.1 Main Brogssser 


The processor board contains a Motorola 68000 microprocessor supported by all the neces- 
sary buffers and transceivers. It includes a memory map and a variety of local peripheral 
devices, including a console port, a realtime clock and calendar, a switchpak for configur- 
ing certain features, and status LEDs. Performance features include scratch RAM, cache 
memory, and a variety of read and write registers. 


The 68000 microprocessor has a 16-bit data path and a 24-bit address path. This allows it 
to directly address 16M bytes of memory space. In this system, the space is divided so that 
the lower 8Mbytes access main memory through the memory map and the upper 8Mbytes 
addresses processor system resources (i.e. PROM, local registers, I/O, Multibus, etc.). This 
selection is made by a decode of the high-order address bit (A23). 


Multibus is a trademark of Intel Corporation. 


** UNIX is a trademark of Bell Laboratories. Plexus Computers Inc is liccnsed to distribute UNIX under 
authonty of AT&T. 


Plexus Computers Page 1-1 


Equipment Overview P/35 User's Manual 


1.1.1 PROM 


The processor board’s PROM contains the instructions and exception vectors used during 
self-test and initialization. It is accessed alter reset and until the BOOT self-test is cleared. 


1.2 Memory Array 


The P/35 dynamic RAM ts contained on one or two memory boards which go in the top 
two slots of the card cage. Standard memory boards provide 1M byte of memory; memory 
boards are also available in either 256K or 512K increments. The P/35 needs a minimum 
of 1M bvte of memory to operate well. 


All memory access is over connector P2, which provides a 32-bit data path. Power and 
ground are the only connections to the Multibus. 


Memory boards provide their own relresh, and error detection and correction (EDC). 
Single-bit errors are corrected and double-bit errors cause a buss error. 


1.3. Input/Output Controller 


Intelligent Communications Processors (ICPs) handle data movement between terminals 
and printers and system memory. They use direct memory access (DMA) to bypass the 
CPU, freeing it from handling all I/O interrupts. Each ICP controls eight serial ports (ter- 
minals or modems) and one parallel port (printer). Plexus configures each P/35 for one or 
two ICPs at the factory. 


1.3.1 Serial Ports 


Eight RS232C serial ports support baud rates from 50 to 19.2Khz by programming a Zilog 
CTC Counter/Timer. Each port has its own DMA channel to move data from local 
memory to the transmit line. 


1.3.2 Parallel Port 


The ICP has a single parallel port used to connect an industry-standard (Centronics-type) 
printer. Control logic associated with the port transfers data to the printer without inter- 
vention from the CPU. 


1.3.3 Local Memory 


The ICP is equipped with 32K bytes of dynamic RAM that stores operating instructions for 
the ICP and bullers data between transfers. 


1.4 Intelligent Mass Storage Controller (IMSP) 
IMSP is an intelligent disk and tape controller that contains its own Z8001 microprocessor. 
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It receives commands from the CPU to move blocks of data between system memory 
(RAM) and the disk drives or tape drive. It has 128K bytes of local RAM which it uses to 
buffer a number of sectors, to decrease the number of disk accesses when the system experi- 
ences a heavy processing load. These buffers store the information [rom the disk and pass 
it to each process as if it were the only process using disk. 


The IMSP uses an industry-standard SMD type disk interface. The intelligent tape drive 
performs many of the functions normally required of the tape controller. It communicates 
with the IMSP over eight data lines and eight control lines. 


{1.5 Standard Peripheral Configuration 


The IMSP supports a number of industry-standard disk and tape drives, so it is possible to 
configure a wide variety of systems. However, the Plexus-standard combination of a [ixed 
Winchester disk and streaming cartridge tape drive has proven to be very flexible and cost- 
elfective. 


1.5.1 Disk Drive 


Plexus P/35 can be equipped with one of four 8-inch lixed Winchester disk drives in 22, 
36, 72. or 142.6 Mb capacities. Additional disk drives may be added in a separate cabinet. 


1.5.2 Tape Drive 

The P/35 comes equipped with a 45M-byte streaming cartridge tape drive. It has 8000 bpi 
storage density on 9 tracks, and can store 45M-bytes in approximately 9 minutes. P/35s 
shipped belore May, 1984 have 22 Mb cartridge drives of a 4-track design. The 45 Mb 
tape drive can read tapes produced on the 22 Mb drive. 


1.6 Physical Description 


This section describes the physical characteristics of the Plexus computer system, introduces 
its primary controls, lists the required operating power and environmental conditions, and 
describes the optional expansion configurations available. 


1.6.1. Physical Characteristics 


The Plexus P/35 computer is a compact, single-unit, self-contained (except for a terminal) 
computer system (see Figure 1-1). This unit can be mounted on a table, a shelf, into a stan- 
dard 19-inch RETMA rack, into a custom Plexus rack, or on top of a Plexus-designed Sys- 
tem Expansion Module (SEM). 
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Cartridge Tape 
Loading Aperture 


~ 


System Power 

Keyswitch 
System Power 
Indicator 


Figure 1-1. Standard P/35 System 
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The P/35 enclosure houses a cartridge-type tape drive, an 8-inch winchester-type disk drive, 
a power supply, and up to 6 processor, memory, and controller printed circuit cards (see 
figure 1-2). Access to this equipment is gained via removable top, and side covers. The 
front control panel can also be removed when necessary. All input/output connections 
(including power) are made at the rear panel. 


The basic P/35 disk facility can be expanded from one unit up to four disk units by using 
either the Plexus Storage Expansion Module (SEM) unit or a rack. 


The use of a SEM limits the expansion of the disk facility to three disks, one internal and 
two external (in SEM). 


The use of a standard RETMA rack to mount the add-on disk units and, if desired, the 
P/35 unit, enables up to three 14-inch disk drives or three 8-inch disk drives to be added to 
the basic system. 


A P/35 system can be connected to an Ethernet* Local Area Network (LAN). In such a 
network, the user can, transparently, access files and devices and can also execute jobs on 
any other Plexus computer in the network. 


1.6.1.1 Controls and Indicators 
The only system controls are: 


1. A SYSTEM POWER on/off keyswitch and a power on indicator which are mounted 
on the front panel of the unit and 


to 


A RESET pushbutton which is mounted on the rear panel of the unit. The RESET 
pushbutton, when pushed, resets the processor and reboots the system software. 


1.6.1.2 Dimensions and Weight 


Dimension English Metric 
Height LE in. (28 cm) 
Width 19 in. (48 cm) 
Depth 26 in. (66 cm) 
Weight 85 Ib (39 kg) 


Shipping weight 95 Ib (43 kg) 


Ethernet is a trademark of Xerox Inc. 
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Figure 1-2. P/35 System, Primary Components 
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1.6.2 Power Requirements 


The P/35 computer is available in either a | i5vac or a 230vac version. Unless ordered oth- 
erwise, Plexus will ship the 1 15vac version. The power required is: 


115vac (+ or - 10%) 49-61hz ((@ 6A) (Plexus default) 
230vac (+ or - 10%) 49-61hz (@ 3A) 


The amperage indicated ts only for a standard configuration, that is, a single disk drive and 
one memory board. Additional equipment will increase the amperage requirements. 


1.6.3 POWER SUPPLY 


The P/35 is equipped with a multiple-output, switching power supply which provides over- 
voltage and short-circuit protection. It supplies the following dc levels: 


Volts Amps(max. ) 
+5 at 45 
+12 at 10 
—12 at 10 
+24 at 4 
—5 at 4 


1.6.3.1 Environmental Requirements 


The system requires the following environment to operate properly: 


‘Yemperature ........ 40-100F (5-38C) 
Humidity ........... 20-80% noncondensing 


1.6.4 System Expansion Module 


A custom designed System Expansion Module (SEM) is available for the P/35 system. This 
unit is a small cantilever desk designed to hold a single P/35 computer and to expand its 
disk capability to three disk units (one internal, two external). The SEM (see Figure 1-3) 
consists of a top, a column and a base. The column can house two 8-inch disk units and 
their associated cables, the base can house the disk drive power supply units. Instructions 
for mounting a P/35 system onto a SEM are given in the manual "SEM Installation Guide". 


1.6.5 Rack Mounted Systems 


Plexus does not supply, as standard, rack-mounted P/35 systems. Plexus. however, does 
supply kits which permit these systems to be mounted into a standard 19 inch rack. Contact 
Plexus for further information. 
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1.6.6 Ethernet 


To connect a P/35 to an Ethernet network requires the installation of an Ethernet controller 
board and its applicable network cable into the system card cage, and a cable and a tran- 
sceiver to connect the P/35 to the Ethernet coaxial network cable. The installation of the 
Ethernet equipment is described in the manual "Ethernet Installation Guide". 
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STARTUP, SHUTDOWN, AND TAPE DRIVE OPERATION 


This chapter describes how to start up and shut down your Plexus computer. It assumes 
that the computer is installed correctly, the system console is attached, and all parts are 
functioning correctly as described in the {nstallation Guide, which ts included with this pro- 
duct. 


This chapter also contains instructions for the use of the tape drive. 


2.1 Normal Startup 


When you turn the power on or press the RESET button, the system automatically begins 
its startup routine. I[t completes its selftest, then waits for the command to boot the operat- 
ing system. When the operating system is booted (loaded {rom the disk), the system comes 
up to single-user mode (state 1). ‘The system can be used in state 1 or brought to multi- 
user mode (state 2). 


A step-by-step procedure is provided later in this section. 


2.2 PROM Selftest and Diagnostics 


The system sel{test program activates immediately after the system is powered on or reset. 
As it completes its tests, the message PLEXUS SELFTEST REVX.X COMPLETE 
appears on the console. Partial completion of this message indicates sel{test failure. Typi- 
cally, the words PLEXUS SELFTEST REVX.X appear quickly and the word COM- 
PLETE takes longer. 


Most systems contain an improved bootstrap PROM that monitors system performance dur- 
ing the bootstrap procedure. If the system cannot complete the bootstrap procedure, it 
returns an error message either directly before or alter the message :/sys3. 
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2.3 Startup Procedure 


P/35 User's Manual 


The visual display and necessary action to start the system are shown below. User 


responses are shown tn bold: 
PROMPT/ACTTION 


COMMENTS 


|PLEXUS SELFTEST REVx.x COMPLETE | Indicates system has 


PLEXUS PRIMARY BOOT REV X.Y 


> <return> 

:/ays3 

SYS3/x.x: sys3.xx 

real mem = XxXxxxx bytes 
avail mem = Xxxxxx bytes 
sys3 


single user 


fsck * 


# init 2 

errdemon started 
cron started 
initializing ICPs 
multi-user 

type ctrl-d <ctri d> 
login: 


passed selftest. 


Screen displays boot 

prompt. Press <return> key to 
continue, of start standalone 
programs. 


Screen displays program 
to be booted, followed 
about 30) seconds later by 
a report as shown here. 
When the superuser 
prompt (#) ts displayed. 
the system is in state 1. 


Plexus Computers recommends 
that the program fsck be 

run to ensure file system 
integrity before doing 

init 2. 


Enter this line after 

the superuser prompt to 
change to state 2 and 
send logins to terminals. 


Type <ctrl d> to send login 
prompt to console. 


*The program fsck is described in the Plexus Sys3 UNIX Programmer's Manual. 


For new installations where no logins have been implemented, login as root (type root). 


As shipped trom Plexus, the erase character is °#° and the kill line character is ’@’. To 
erase a character, follow it with a ‘*#° (EXAMPLE: px#s = ps). To erase a line, type a 
‘@’. The line will be ignored and the cursor will move to the next line. 


If the startup sequence fails, see the chapter, “Crisis Recovery”’ for corrective action. 
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Systems that shipped with earlier version software but have been upgraded to release 3.1, 
might retain "pd(0,0)sys3" as the boot pathname. When the <return> is entered, the sys- 
tem displays: 


PLEXUS PRIMARY BOOT REV 1.0 
:pd(0,0)sys3 


This is an acceptable substitute which does not change the system startup procedure. 
CAUTION 


Yo avoid system failure, read the chapter, “The Standalone 
Environment,” before booting any program other than the 
default (“pd(0,0)sys3" or "/sys3"). 


2.3.1 Logging In 


Plexus systems are shipped with a few active accounts, one of which is root. You must 
create the other user accounts in due time. At this point, however, if you would like to 
check the login procedure on this system, enter: 


root 


in response to the Login prompt. The system will respond by returning some basic mes- 
sages regarding the revision level of the operating system software, followed by the root or 
superuser prompt, #. 


At this point the root account has no password. You can add one now or wait until you 
encounter the procedure in the chapter. “Setting Up Your Installation,” where it is 
described in detail. 


2.3.2 Shutting Down the System 


After you have logged in as root (presumably from the system console), you may want to 
shut the system down before proceeding further. To do so, 


1. Be sure you are logged in as root on the system console. 


to 


Enter: 
/ete/shutdown X 
where X = seconds of grace period (default = 60 sec) 


3. The program /ete/shutdown sends a series of messages to all active terminals, warning 
that the system will shut down in X seconds (the length of the grace period men- 
tioned above). 


4. The program takes several minutes to execute, during which time the user is 
prompted for yes/no responses when necessary. When it asks: 
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Busy out (push down) the appropriate phone lines for this systoen. 


Do you want to continue ? (enter y or n) 
Hang up any modems and enter: 


y 


5. The system displays some messages, which may take a lew minutes. It displays a list 
of processes (ps -eaf). then asks: 


Will a file save be done at this time (enter y or n). 
The appropriate line in the list of processes should read: 

INIT 1 

Respond by entering: 


m 


NOTE 


If y is entered, /etc/shutdown displays the message: 


fsck will now be executed on files 
in checklist 


The complete fsck functions are completely displayed as 
described in the Plexus Sys3 UNIX Programmer's Manual. 


6. The system displays the message: 
Halt the system when ready. 


7. The system is now in state 1. It may be used in single-user mode, or shut down by 
pressing the RESET button on the system front panel or turning the SYSTEM 
POWER keyswitch to its off position. 


CAUTION 


If the system is used after the shutdown program is finished, 
enter: 


sync ; sync 


before pressing the <reset> button or removing power. 
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2.4 Using the Tape Drive 


The standard tape drive included with the P/35 uses self-contained cartridges which greatly 
simplify operation as compared to standard 9-track open-reel tapes. There are no controls, 
switches, or indicators on the P/35 associated with the tape. All such functions are handled 
by software commands. In addition, the cartridge itself features a write-protect switch. 


2.4.1 Basic Operation 


The tape cartridge itself has a switch labeled SAFE. If you turn the tab so the arrow 
points to SAFE, the tape can be read but not written to. Plexus recommends vou set all 
software release tapes to SAFE to prevent losing your ultimate backup copies of system 
and application software. 


Other than the SAFE switch, basic operation of the cartridge drive consists of inserting 
the cartridge into the tape slot provided on the front panel of the P/35. Insert the cartridge 
such that the label is facing up and the SAFE switch and center pinch roller face away 
from you and toward the rear of the tape slot. 


2.4.2 Features 


P/35s shipped from May, 1984 onward have 45 Mb tape drives with 9 tracks. These units 
are streaming tape devices, but do not appear to be so during operation. For a given seg- 
ment, the drive moves the tape back and forth 9 times to completely [ill up the tape before 
moving on to the next tape segment. This feature makes the drive [aster to use because it 
does not have to rewind the entire tape before writing (or reading) the next track. 


These newer drives can also read tapes written by the pre-May 1984 20 Mb 4-track tape 
drives. Figure 2-1 illustrates how this is possible, and also shows the 9-track **sidewinder”’ 
pattern in which it streams data onto the tape. Tapes written by the 45 Mb 9-track cartridge 
drives cannot be read by the 20 Mb 4-track drives, however. Because the 9-track 45 Mb 
drives operate to such close tolerances, head alignment and tape tension are critical factors 
in successful transfer of tapes [rom one drive unit to another. 


2.4.3 Warnings 


This section describes special considerations for most efficient and successful use of P/35 
cartridge tape drives. 


2.4.3.1 Retensioning 


The tape drive manufacturer recommends that you retension the cartridge tapes before first 
use, before any read or write operation involving two or more megabytes of tape, and after 
two weeks of inactive storage. ‘fo retension the tape, enter [rom any terminal: 


/usr/plx/tape retension 


This retensioning rule applies to all tape utilities. 
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2.4.3.2 Specifying Density and Length 


When using the dump utility with the +5 Mb drive, you will obtain more consistent results 
by specifying the tape length and density according to the syntax of dump as described in 
the Unix Programmer's Manual — Vol 1A. Vapes are 450 feet in length; the density con- 
stant is 82. Thus, as an example. to perform a dump of /dev/dk3, you would enter: 


dump fsd /dev/rpt0 450 82 /dev/rdk3 


2.4.3.3 fbackup Capacity 


For 20 Mb drives, the tape capacitv when using fbackup ts 36000 512-byte sectors. 


20 Mb Format 45 Mb Format 


tHE 
INUIT 


Figure 2-1. 4-Track and 9-track Cartridge Tape Formats 
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SYSTEM ADMINISTRATION CONSIDERATIONS 


This chapter provides an overview of the factors you must consider to be an effective UNIX 
system administrator. 


The objective of system administration is to keep your system optimized to the purpose of 
your particular installation. The UNIX system is large and complex enough to aliow a wide 
variety of performance and storage capabilities within a given computer model. It is the sys- 
tem administrator’s job to configure and maintain these capabilities so the computer realizes 
its full potential for a particular purpose. 


For example, engineering and accounting departments might both have 8-user, | MB 
RAM, 142MB disk P/35’s. The accounting department might assign all 8 ports to secre- 
taries and bookkeepers running word processing and spreadsheet applications on interactive 
terminals. The engineering department might use only four terminals, but have three dif- 
ferent language compilers and a text formatter running at once. These two identical com- 
puters should be set up very differently within certain UNIX files so that each system real- 
izes its performance potential for that particular installation. This configuring and system 
“tuning” is the domain of the system administrator. 


3.1 Disk Mapping 


When configuring a new system, the normal action is to get started as soon as possible: con- 
nect and turn on the system, boot up, log in as root, and modify and add the files and user 
directories. While it is a good idea to turn on the system, boot it, and log in to ensure that 
your system works properly, it is best not to proceed any further than that without some 
off-line planning. You can save yourself much repetitive work if you first determine how 
much disk space you have and how you want to sub-divide the disk into file systems before 
adding or modifying anything. 


The three primary logical divisions of your disk are: 
® The swap area 


® The root file system 
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e The mounted file system(s). 


You should allocate your disk space before configuring any files or loading any other 
software because if you want to increase the size ol the root tile system or greatly enlarge 
the swap area, you will have to configure that first with the standalone programs, deonfig 
and mkfs, and then reload the UNIX system trom your soltware tape. 


Disk mapping includes: 
e The size and location of your swap area 


e The size and boundary of the root file system if you want one larger than the default 
(18MB) 


e The sizes and boundaries of the other (mounted) file systems 


e {he directories on which these other file systems will be mounted 


3.1.1 Determine Swap Space 


The P/35 is shipped with the software installed and the disk mapped. On systems shipped 
with Sys3 rev. 3.12 or earlier the default swap area is 2 MB. Systems shipped with Sys3 3.2 
or later have a factory-set 4- or 6- Mb swap area. If you have an earlier model your instal- 
lation probably needs a larger swap area. The system administrator must determine the 
swap area required and implement it. The following factors can help you determine how 
much swap space is needed: 


Factors Comments 


Number of Users As the number of users increases, so does the amount of 
processing and swapping required by the system. Swap 
area should be added in proportion to the number of 
users projected to use the system at any one time. Score 
one point for each user you project to be on your system 
at anv one time. 


Number of Processes A system with a few users each running several processes 
at once is equivalent to a system with several more users. 
Swap space must be increased according to the projected 
number of simultaneous processes regardless of the 
number of people actually logged in. Score one more 
point for each extra process you anticipate your users will 
have running in background in addition to interactive 
tasks. 


Page 3-2 Plexus Computers 


P/35 User's Manual System Administration Considerations 


Types of Processing Installations for software development, documentation, 
and scientific applications require more swap area than 
office environments running primarily accounting and 
inventory applications unless they are on a database 
management system. Score four points for each database 
management system, text formatter, and/or language 
compiler that will be in use on a typical day. ____ 


Background Tasks Dilferent systems (and different system administrators) 
implement varying amounts of automated background 
processing. This can take the form of cronfiles, printer 
schedulers, connecting your system to a telephone line 
network such as USENET, etc. Score four points for 
each such task your system will run on a fairly regular 
basis. 

Now total up your points and divide them by four. Round any fractions up to the next 
whole number. The result is the number of megabytes of swap space you should implement 
on your system. This is an approximate answer. If your final figure is fairly high (8 Mb or 
above), you can probably adjust the swap area up or down by 2 megabytes to avoid compli- 
cations when writing to dconfig. (See the chapters, “Configuring Disks’” and “The Stan- 
dafone Environment”’ for more information on running dconfig.) 


3.1.2 Set Up the File Syst¢ms 


The system administrator must also decide how to divide the rest of the disk space into file 
systems. File systems can be considered logical, rather than physical, disks. The system 
administrator assigns each file system a device number and a directory on which it is 
mounted. 


There are two categories of [ile systems, the root file system, and the mounted [ile systems. 
The root file system is available whenever the system has been booted into any initialization 
state (see the chapter, “Changing System Initialization States’’). It must exist for UNIX to 
run at all. The system administrator can also increase the size of the root file system. 
Regardless, the system administrator ts responsible for setting up the number and size of the 
mounted file systems. These become active when the system is initialized into a multi-user 
state. 


The following factors are involved in allocating disk space to set up the file systems. 
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Factors Comments 
Logical Functions Disk space is usually divided up according to the func- 


tions important to your installation and the manner in 
which you want to organize your backup tapes. E.g., in 
addition to root, you might want separate lile systems for 
user accounts, proprietary files, archives, general access 
files, the spooler, an on-line manual, etc. 


Disk Capacity You cannot set up more disk space than is physically 
available. If you have defined file systems totaling 80Mb 
and you have 72Mb disk space available, you need to 
either economize the allocations or add another disk. 
The number and sizes of these file systems are ultimately 
determined by your system's disk capacity. 


User Space Tf you elect to have one or more [ile systems for user 
accounts, the anticipated number of accounts and the 
space they occupy will be a major factor in disk alloca- 
tion. 


Enlarged Root File System Certain installations have two or more kernels that can 
be booted alternately. Some installations acquire or 
create additional utilities to run in the root file system. 
Although the Plexus disk is set up to accommodate some 
growth in the root file system, enough extra kernels 
and/or utilities could require that it be enlarged. 


Backup Capacity Most UNIX systems are backed up onto tape using the 
dump utility. dump creates an image of the entire logical 
disk onto tape. Therefore, it is best not to create a file 
system larger than the capacity of your tape backup facil- 
ity. 


Security When UNIX is booted into single-user mode, the person 
at the console often has password-free super-user access 
to any file on the root file system. This factor may influ- 
ence the size and contents of the root {ile system as well. 


3.2 Create Accounts 


The system administrator ensures that all authorized users and groups have access to the 
system by creating “user accounts’? on the system. This involves adding the person’s or 
group’s name to /ete/group and /etc/passwd files, creating directories in those names, and 
configuring a .profile or .cshre file for that person’s account to determine the pathnames 
and priorities for that person or group. 
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3.3 Establish Security 


The system administrator establishes the levels of accessibility of all files in the system. The 
areas of control include the following: 


Factors Comments 


Group Accounts In addition to creating user accounts, the administrator 
can establish group level security as well by establishing 
group ids in /ete/group. This practice can separate func- 
tions and projects that share the same machine. 


Permissions Levels The system administrator can set and reset the permis- 
sions levels of any and all files and programs on the sys- 
tem. ‘his determines what individuals and groups can 
read, write, and/or execute which files and programs. 
(See the manual pages on /ete/passwd(5), /ete/group(5), 
chown(!,), chgrp(1), and chmod(1,).) 


Ownership The system administrator can change the individual and 
group ownerships of any files on the system to meet 
specific accessibility paths. (See chown(1) and: 
chgrp(!)). 


Root Password The system administrator sets the root password when 
logging into the system for the very first time alter suc- 
cessfully booting it into multi-user mode. The root (or 
superuser’) password has read/write access to every [ile 
and program in the system. The system administrator 
decides who, if anybody else, also knows the root pass- 
word. 


SCCS SCCS is UNIX’s Source Code Control System, but it can 
be used to archive. control access, and document change 
to any files desired. The system administrator decides 
what files, if any, will be placed under SCCS, who will 
have read-only access, and who will have change 
(read/write) permission to the files. 


3.4 Configure Device Software 


As your office or lab (and consequently your system) grows, you will lind a need to add or 
change peripheral devices attached to your system. When adding terminals, printers, tape 
and disk drives to Plexus hardware, you also have to alter certain UNTX files or run certain 
standalone programs to enable the software to ‘see’? the new devices. The individual con- 
siderations are indicated below: 
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Factors Comments 


Interactive Terminals When adding a video display terminal the system 
administrator must activate a “‘getty’’ for the terminal 
port in /etc/inittab, create the device in /dev, find or 
create a termcap entry in /etc/termcap, and enter the 
termcap entry in /etce/ttytype to ensure the terminal will 
demonstrate all compatible functions with UNTX and the 
Plexus hardware. 


Serial Printers Serial printer can be attached to the serial ports. The 
administrator must ensure that device Ip exists in /dev to 
provide for printer control, find or create a termcap 
entry, reconfigure a line in /ete/inittab, and possible 
write a ‘‘lilter’”” program to ensure a workable interface. 


Parallel Printers One parallel printer attaches to the parallel port of each 
ICP. The system administrator must ensure that device 
pp exists in dev and reconfigure a line in /ete/inittab. 
The spooler, Ip provides for printer control. 


Disk Drives Besides ensuring that an auxiliary disk is installed 
correctly, the system administrator must run dconfig to 
alter the upper boundary of disk space available, use 
mknod to make nodes for block and character devices 
corresponding to the new logical disks (file systems) 
represented by the new physical disk, make new Tile sys- 
tems via mkfs, mount the new [ile systems to existing or 
new directories, and add the devices to /ete/re so they 
will automatically be mounted and unmounted when the 
system passes between single-user and multi-user states. 


Modems If your system is going to be linked with the outside 
world via telephone lines, the system administrator must 
assign a tty port for that line and ensure that the baud 
rate and other characteristics are established in 
/etc/inittab and possibly /usr/lib/uucp/L-devices. 


3.5 Perform Backups 


The system administrator decides how the contents of the system disk(s)} will be backed up 
onto tape, and when. Below is a table of considerations: 
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Factors Comments 


Who The system administrator decides whether (s)he will do 
it, or assign the duty to someone else (preferably a con- 
sistent, responsible person with a good attendance 
record). The system can be programmed to perform the 
backups automatically overnight, but someone has to 
take the old tape out each day and stick the new one in. 


What {ft is up to the administrator as to what parts of which file 
systems get backed up on particular days of the week or 
month. This manual suggests a schedule in the chapter, 
“Periodic System Routines,” but it is up to the system 
administrator to decide what is best for the individual 
installation. This decision is more crucial if you use the 
standard P/35 20MB or 45MB cartridge backup, because 
attempting to back up too much at once could require 
changing tapes at a time when no one is there to do so. 
The optional 9-track open-reel backup device provides 
up to 80 Mb backup space on a 2400 foot reel if using 
dump or fbackup. This should obviate tape switching in 
most cases. 


When A full dump of file systems works best if the [ile system 
is first unmounted to ensure that no one changes it dur- 
ing the backup. Since most installations have rather 
large disk capacities, it is best to perform such backups 
overnight. Smaller systems, however, might have back- 
ups done at lunch time. 


How UNIX offers six different utilities that can copy disk con- 
tents to tape — dump, cpio, tar, dd, fbackup, and vol- 
copy. [t is the system administrator’s responsibility to 
know the merits and drawbacks of each of these utilities, 
and prescribe the one(s) best suited to the installation. 
(Plexus recommends using a utility that backs up the 
entire file system. ) 
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3.6 Crisis Intervention 


The system administrator must respond whenever the system sends a crucial error message 
to the console. slows down to an intolerable level, or crashes. Duties within this category 
include: 


Factors Comments 


Kill Processes Runaway processes can quickly use up all available file 
and swap space. The system administrator may try to 
identify the delinquent process, invoke the superuser 
password, and kill the process. 


Bring System Down — System “‘panics,”’ damaged file systems, and other factors 
may require that the system be brought down for mainte- 
nance. The system administrator must see that all users 
are notified (this can be done automatically with 
/etc/shutdown) so they can quit their files and log out (if 
‘possible) to minimize or eliminate any lost files. 


Bring System Up Power failures. brownouts, hardware problems, and ker- 
nel problems can cause the system to “go down” 
automatically. Power fluctuations at night can result in a 
“dead” system tn the morning. The system administrator 
must bring the system back up and see that an alternate 
person is also entrusted with that duty. 


Repair File Systems Some types of crashes can damage file systems. The sys- 
tem administrator must respond to any such occurrence 
at whatever level is necessary. This may involve running 
fsck in init | and respond to some prompts and/or res- 
toring the most recent full dump, or it may involve run- 
ning dformat, dconfig, mkfs, and restoring the entire 
system. 


Report Bugs The administrator should notify Plexus Software Support 
of any software problems encountered. Plexus may be 
able to offer a work-around solution over the telephone, 
mail out a fixed version of the software, or see that it is 
fixed for the next soltware release. 


Get Help As system administrator you have a lot of responsibili- 
ties, but no one expects you to know everything about 
the system, or be able to repair components. The system 
administrator must know when the system needs outside 
help. and procure it. 
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3.7 Implement Special Features 


Probably your system runs some applications or enhancements such as optional language 
compilers, a data base management system, word processing, electronic spreadsheet, etc. 
The system administrator allocates the file system and directory for such software packages 
and installs it there. Some applications require several megabytes of disk space; the system 
administrator must locate such applications in sufficiently large file systems. The location 
also affects the pathnames each user must speci{y to use the application, and the amount of 
alteration to user .profile or .cshre files. 


In addition to installing application programs, the system administrator can implement cer- 
tain utilities on a UNTX system as shipped from Plexus. These utilities include SCCS (a 
read/write/change control system for source code and critical documentation) and UUCP 
(UNIX to UNIX Communication Protocol which allows batch communication between 
UNIX machines via modem and telephone lines). 


The system administrator can elect to automate any number of routine system commands 
by invoking or writing shellscripts and makefiles. Shellscripts and makefiles can automati- 
cally bring the system up multi-user; shut the system down gracefully: perform a schedule of 
backups; sort, collate, format, and print large documents: prevent runaway processes from 
exceeding system capacity; and perform any other duties which require a multiple number 
of tasks in either a predictable or conditional pattern. 


3.8 Install New Releases 


Throughout the year Plexus issues updated, improved, and further debugged versions of the 
UNIX operating system. Occasionally, Plexus also issues updates to a current release. When 
your company receives updates or new releases to the operating system, tt is the system 
administrator's duty to install the new soltware promptly and correctly, making sure all 
current files are safe and can migrate to the new environment. 
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SETTING UP YOUR INSTALLATION 


This chapter contains a sequence of software installation and configuration procedures that 
minimize repetitive commands and superfluous system startups and shutdowns. Each sec- 
tion contains the procedure for a certain phase in setting up your Plexus computer and the 
sections themselves are in sequence as well. 


The procedures in this chapter assume you have followed all hardware connection and 
power-on procedures in the P/35 {nstallation Guide belore beginning here. 


4.1 Run mkfs and/or dconfig (Maybe) 


The Plexus utility, deonfig, can alter the fundamental organization of your disk(s) if run in 
the standalone (i.e., UNIX is not booted) mode. Therefore, if you need to change some 
disk parameters via dconfig, do so before booting UNIX. This ensures that the disk is prop- 
erly set up for your needs before you conligure any root files. 


You should run standalone deonfig before booting UNIX under any of the following cir- 
cumstances: 


e You want your root file system larger than the default 18 Mb. 
You need to change the location of the swap space to map in the extra room for 
/dev/dk! on which the root file system resides. Then you must run standalone mkfs 


specifying the new size of the root file system, followed by re-restoring your Sys3 
soltware from the tape supplied with your system. 


e Your system needs more than the default swap area. 
Default is 2 Mb on ail systems shipped with Sys3 3.12 or earlier and 6 Mb on sys- 
tems shipped with 3.2 or later except for 22 Mb versions which have 4 Mb swap. 


e You want your swap area moved to a difterent logical disk than that of the root file sys- 
tem. 
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If the second or third of the above items apply. the procedures are contained under 
appropriate headings in the chapter titled “Configuring Disks.”” The procedure to increase 
the size of the root [ile system ts contained in this chapter. 


If none of the above items apply. proceed to the section, ‘Booting from Disk.” 


4.1.1 Invoking dconfig before Booting 


The tollowing procedure provides the correct sequences when invoking dconfig prior to 
booting your system, specilically: 


a. ‘[o make vour root lile svstem larger than the detault 18 Mb 
b. ‘To enlarge or move the swap area 


The procedure is divided into main steps and subroutines. Main steps increment by arabic 
numerals (1, 2, 3, etc.) and represent steps to be followed by anyone invoking dconfig for 
either of the reasons stated above. Subroutines are identified by a condition set in italics 
(e.g., /f you are increasing the swap area). Subroutines increment by lower case alphabeti- 
cal characters (a, b, c, etc.). If the condition of use set in italics does not match your need, 
proceed to the next subroutine or to the next main step (marked by an arabic numeral). 


1. Turn on the system according to the procedure in the P/35 Installation Guide but DO 
NOT BOOT THE SYSTEM. 


i) 


Invoke standalone deonfig [rom tape by entering the command marked in bold 
immediately alter the boot PROM prompt. 


PLEXUS SELFTEST REV X.X COMPLETE 


PLEXUS PRIMARY BOOT REV X.X 
-dconfig <return> 


2a. Lf vou are increasing the size of the root file system, follow this sub-procedure: 


a. Change the swplo sector address to mark the new upper boundary you want for 
the root file system, or move the swap device to a different /dev/dk number 
altogether. The details of these procedures are in the “Conliguring Disks” 
chapter under the procedure, “Increasing Swap Space.” 


b. Make sure the new length of /dev/dk! does not run into the start sector address 
of the next logical disk you intend to mount and use on your system. For exam- 
ple, if the /dev/dk2 start address default is offset 40000 and you increased the 
swap area to 12000 sectors starting at offset (swplo) 36000, you must change the 
start sector address of dev/dk2 from 40000 to 48000 so the swap area does not 
run into the start of /dev/dk2. 


c. After exiting deonfig, the system again returns the boot PROM prompt. Invoke 
the standalone mkfs command by entering the command marked in bold 
immediately alter the boot PROM prompt. 
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PLEXUS SELFTEST REV X.X COMPLETE 


PLEXUS PRIMARY BOOT REV X.X 
:mkfs <return> 


d. Create a new larger file system for /dev/dk1 by entering the following com- 
mand: 


$$mkfs /dev/dkl xxxxx mn 


where Xxxxx is the new number of IK blocks you want lor the root file system; 
m is the **m” or interlace factor, and n is 500 for all systems through Sys3 
release 3.2 All systems with an IMSP disk controller (pd) have an interlace of 
1. The system responds with a count of the isize and m/n factors, then exits to 
the boot PROM prompt again when finished. 


e. Now reload the root file system [rom the software tape by invoking standalone 
restor. 


PLEXUS SELFTEST REV X.X COMPLETE 


PLEXUS PRIMARY BOOT REV X.X 
:restor <return> 


When the system returns the standalone prompt, enter the following parts 
shown in bold: 


$$restor r/dev/dk! +nn 


where nn is the number of dump files on your soltware tape. The system 
responds: 


Spacing forward nn files on tape 

Last chance before scribbling on /dev/dki. <return> 
End of tape 

Exit oO 


Expect a long (“45 minutes) wait between pressing <return> and receiving the 
End of tape message. 


WARNING 


Do NOT press <reset> before the system returns the 
Exit O message. 


2b. If you are moving or enlarging the swap area only, observe the following sub- 
procedure: 


a. To enlarge the swap area, specily a higher limit on the nswap prompt and then 
make sure the beginning sector address of the next highest /dev/dk# does not 
interfere. 
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b. To move the swap area, specily the /dev/dk# of your choice in response to the 
swapdev prompt. and adjust the swplo and nswap sector values accordingly. 


NOTE: 


The details of these procedures are contained in the chapter, 
“Configuring Disks” under the procedure, “Increasing Swap 
Space.” 


c. Exit deonfig. 


3. You are now ready to proceed to the next section, “Booting from Disk.” 


4.2 Booting from disk 


If you have satisfied vour needs in the previous section or intend to use Plexus’ settings for 
/dev/dk1 and swap size and location, you are now ready [or this section. 


This section shows how to boot UNIX properly and safely from disk, bring it up as a 
multi-user system, and prepare it for lirst use as root. 


Before you ‘‘Boot”’ 


The expression “booting the system” relers to the process of loading the operating system 
from the disk into system memory. This takes place during the startup procedure when you 
first press <return> in response to the boot PROM prompt. 


The boot name is the name of the kernel which ts to be loaded into system memory. The 
system attempts to boot whatever you enter in response to the boot prompt. You may either 
type something or press <return>. Pressing <return> invokes the delault which boots 
whatever file has been designated as the primary boot pathname. Plexus systems are 
shipped with the primary boot pathname, /sys3. Specilying a kernel by name allows you to 
keep and load dillerent versions of the operating system. You can change the primary boot- 
name with the program, dconfig. 


Boot your system [rom disk using the following procedure. 


1. Turn the system on, or if it ts on, press <reset> on the computer itself to receive the 
boot PROM message: 


PLEXUS SELFTEST REV X.X COMPLETE 


PLEXUS PRIMARY BOOT REV X.X 


tN 


To boot from disk, respond by pressing <return>. The console then displays the 
following messages: 
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:/sys3 [or pd(0,0)sys3] 


SYS3/x.x: sys3.xx 


real mem = xxxxxx bytes 
avail mem = xxxxxx bytes 
sys3 

single user 

# 


The shell default characteristics are such that the erase character is # and the kill line 
character is @. ‘lo erase a character, follow it with a # (EXAMPLE: px#s = ps). 
To erase a line, type a @. The system will ignore the line and move the cursor to the 
next line. 


3. Whenever bringing a system up, always perform a file system consistency check (fsck) 
to ensure that the disk files conform to the UNIX file system .before initializing the 
multi-user mode. To do so. respond to the superuser prompt (#) by entering the fol- 
lowing shown in bold: 


# = fsck 


The system then incrementally displays a five-phase response over several minutes. 
The larger the file system, the slower the response. If something is not right, fsck 
prompts you to repair the file system that is damaged. Respond by answering y to the 
questions and then rebooting the system. (The program fsck is described in the 
Plexus Sys3 UNIX Programmer's Manual — vol 1A.) Then perform fsck again before 
proceeding to the next step. 


4. When fsck has finished running satisfactorily, it returns the superuser prompt (#). 
Bring the system into multi-user mode by entering: 
# init 2 
The system responds with the following messages trom the console. Respond as signi- 
fied in bold to get the login prompt something like the one immediately below: 


errdemon started 
cron started 
initializing ICPs 
multi-user 
type ctri-d <ctrid> 
login: 
5. Login as root. 
login: root <return> 
The system displays some login messages and then returns the superuser prompt (#). 


6. Belore doing anything else, add a password for root. The root password is also known 
as the superuser password. The superuser password gives read/write/execute permis- 
sion on any Tile, directory, or program on your system. Obviously root should have a 
password, and it should not be divulged lightly. “To set a password for root, type: 


# passwd 
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‘The passwd program then prompts you to enter and re-enter the password you select 
to ensure its correct entry. 


4.3 Making Things Easier 

At this point, you have a system up with one active account. The default shell for root, 
however, is relatively primitive compared to UNIX’s capabilities. It has no pathnames 
specified, and the system does not know specifically what kind of terminal your console is. 
By defining a few parameters at this point vou can avoid typing lengthy pathnames and 
enjoy the benefits of a full screen editor. This will make subsequent setup procedures much 
easier. 


1. Specify your terminal to the system so you can use a [ull screen editor. You should 
find a mnemonic code in /ete/termcap to match your console terminal. To look at 
/ete/termeap, enter: 


/usr/plx/more /etc/termcap 


When you find the terminal code, specily it to the system. For example, if your ter- 
minal is a DEC V¥T100* or has the exact same termeap., enter: 


#TERM = vt100 
export TERM 


Invoke /usr/plx/vi to examine /etc/ttytype to ensure that the console port ttytype 
matches the “TERM” you specified in the last step. If it does not, change it. 


Ww 


3. Create a .profile file for root to put in pathnames and terminal characteristics to ease 
later tasks. Type the following sequence: 


ed / 
/usr/plx/vi .profile 


4. This creates a new lile named .profile which 1s invoked whenever root subsequently 
logs in. The function of this file is to set up the login environment for root. The login 
environment includes default paths to be searched to find commands, and default ter- 
minal characteristics. 


Add the command paths and terminal characteristics to this .profile according to the 
syntax and example explained in the UN/X Programmer's Manual — vol 1B under 
profile(5). Below is another example of a basic .profile which sets terminal charac- 
teristics and specifies pathnames by priority. Enter everything exactly as shown 
including the single and double quotation marks. 


* DEC and VT100 are trademarks of Digital Equipment Corporation, 
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yA ee 


stty ixon kill "x" erase “"h" echoe 
TERM=vtl00 

PATH= .:/etc:/usr/plx:/bin:/usr/bin 
export TERM PATH 

EXINIT=’set aw number’ 

export PATH TERM MAIL EXINIT 


Write and quit this file. 


Now log out. 


an mm 


Log back itn as root. This causes the system to automatically read the .profile you 
created and set the parameters specilied there. 


4.4 Setting Up File Systems 


The procedures in this section depend on your having followed the last one. For example, 
if you did not set the pathnames in the root .profile and you enter the command mknod, 
the system returns an error message because it does not know the pathname (which is 
/ete/mknod). 


This procedure provides the sequence for activating the rest of your disk space for system 
use. It requires you to: 


a. Create the logical disk devices in the device directory. 
b. Create and size ftle systems on those logical devices. 


c. Mount those file systems to directories. 


To perform these procedures correctly, you must know how much disk space you have, 
how you want to allocate it, and which default start sector addresses correspond to which 
/dev/dk#s in deonfig. Reproduced for your convenience are two tables describing these 
parameters. The first table shows in 1K blocks how much space you have remaining on 
your disk if none of the factory settings have been changed. he second table shows the 
default start sector addresses tor each logical disk. “Old” refers to systems shipped with 
Sys3 version 3.12 or earlier and *"New”’ refers to those shipped with Sys3 version 3.2 or 
later when the swap area (and /dev/dk1) was increased by 4 Mb. In the second table, the 
symbol means to the end of the disk. The first table shows what that end is. 
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TABLE 4-1. Default Sizes (1K blocks) for /dev/dk2 


Disk Size 
22? Mb 8" 
36 Mb 8" 


72 Mb 8" 
142.6 Mb 8" 
72 Mb [4" 
145 Mb 14" 
289 Mb 14" 


TABLE 4-2. 


dk0 [0.0]: 
dk1 [0,0]: 
dk2 {0,0}: 
dk3 [0.0]: 
dk4 [0.0]: 
dk5 [0.0]: 
dk6 {0.0}: 
dk7 [0.0]: 
dk& [0.0]: 
dk9 [0,0]: 
dk10 {0,0}: 
dkit [0,0]: 
dk12 {0,0}: 
dk13 [0,0]: 
dkt4+ [0,0]: 
dk15 [0,0]: 


13405 
47473 
116272 
48085 
116170 

261120 


Early & 22Mb P/35s 


120000,” 
140000,” 
160000,” 
180000," 
200000," 
220000,” 
240000," 
260000,” 
280000," 
300000, 


NOTE 


112170 
257120 


Factory Settings for Start Sector (512-byte) Addresses 


New P/35s 
0,” 
0,48000 
48000,7 
68000." 
88000,” 
108000,” 
128000,” 
148000,” 
168000,” 
188000,” 
208000,” 
228000,” 
248000, 
268000, 
288000,” 
308000," 


Remember that the figures in the first chart are units of IK 
blocks whereas the figures in the second chart are 512-byte 


sectors. 


To set up file systems and allocate your disk space, perform the following procedures: 


1. Be sure you are logged in as root. 


2. Change your working directory to the device directory by typing: 


cd /dev <return> 
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3. Choose from the tables above which dk numbers correspond to the file system sizes 
you want to set up. 


4+. Create the logical disk devices as block devices for each of the dk numbers you chose 
from the previous step: 


mknod /dev/dkX b 0 X 


where X is the dk number in both occurrences. The second occurrence establishes 
that number as the minor device number tor system device tracking. Repeat this step 
for each logical disk you are creating for your system. 


A 


Create the logical disk devices as raw (character) devices for each of the dk numbers 
you chose. 


mknod /dev/rdkX ¢ 3 X 


where again X is the dk number in both cases. Repeat this step to match a raw dev- 
ice for each block device you created in the previous step. 


6. Create the file systems to correspond to these logical devices and assign them sizes in 
IK blocks: 


mkfs /dev/dkX xxxxx mn 


where again X is the dk number and xxxxx is the new number of 1K blocks you want 
for the root file system; m is the “*m’’ or interlace factor, and n is 500 for all systems 
through Sys3 release 3.2 All systems with an IMSP disk controller (pd) have an inter- 
lace of 1. Repeat this step until you have created file systems to correspond to each 
logical block device. . 


7. If you want special directories to correspond to any of the file systems you created, 
create the directories now: 


mkdir /dirpath/dirname 


where dirpath is the path to the directory and dirname is the name of the directory 
you are creating. For example, if you were creating a [ile system named user under 
the /usr directory, you would enter mkdir /usr/user. Repeat this step until you have 
created all the new directories you want to represent ile systems. 


8. Mount the logical block devices to the directories you created or chose in the last 
step: 


mount /dev/dkX /dirpath/dirname 


Repeat this step until you have mounted all the directories you want to represent file 
systems. 


9. Change your working directory to /ete: 
cd /etc 


10. Invoke a text editor such as vi to open /ete/re. Add /etc/umount commands and 
/ete/mount commands lor the mounted /dev/dk numbers you established in the previ- 
ous steps. Following is an illustration of the sections of /ete/re to alter. Sample addi- 
tions are shown in bold. 
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# /etc/re curstate no.-times-prev-in-curstate prevstat 
TZ=PSTSPDT 
export TZ 
.¢ 
case ${1-2} in 
1) 
uname 
echo single-user 
it ([ "$2" != 0 ] 
then 
put umounts here 
fetc/umount /dev/dk4 
/etc/umount /dev/dk10 
fi 
217) 
1¢ [{ "$2" = O J ; then 
cp /tmp/Ex* /tmp/Rx* /usr/preserve 2>/dev/null 
rm ~f /tmp/* /usr/tmp/* /etc/utmp 
fi 


1f [ "$2t = O -o "$2" = "4H ~g "gH = 1 ] 
then 
echo “initializing IMSP° 
sync 
sleep 3 
/etc/dnid -dd -a 5000000 -f /usr/lib/dnld/imsc -o /dev/imo 
/etc/devnm / | grep -v swap | grep -v root | /etc/setmnt 
put mounts here 
/etc/mount /dev/dk4 /user 
/etc/mount /dev/dki10 /uer/spool 
/etc/update 
rm -f /usr/adm/acct/nite/lock* 
1f ({ "$1" = 2 J ; then 
# /bin/su - adm -c /usr/lib/acct/startup 


. Cte. 
Write and quit this file. 


li. Tt is more convenient and safer for the system to automatically perform a file system 
check on all active lile systems when you invoke fsck in single-user mode. ‘To do so, 
invoke a text editor such as vi to open the lile, /ete/checklist. Insert the logical dev- 
ice names you want checked. For example, the /ete/checklist corresponding to the 
/ete/re in the previous step would look like this: 


/dev/daki 
/dev/dak4 
/dev/dkio 


12. Shut down the system gracefully (see the chapter, “Changing System Initialization 
States”’ [or details). 


13. Reboot the system and bring it up multi-user as described in the section, ‘Booting 
from Disk,” in this chapter. 
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4.5 Setting Up /lost+ found 


When UNIX crashes, it attempts to preserve any open [files by moving them to the direc- 
tory, /lost+ found. For this to work, however, there must be some space set up within the 
Nost+ found directory. To set up space you must create some files and then erase them. 
This creates space but removes the pointers to the space; it cannot be transferred on the 
soltware distribution tape. ‘he procedure for setting up /lost + found is given below: 


1. Make sure you are not using the C-shell. If you are, enter: 


sh 


i) 


Change your working directory to lost+ found. 
ced lost + found 


3. Create some null length files. The number of files you need to create is relative to 
the number of open files you anticipate your system supporting at any one time. 
Small systems may need about 10 files. Larger systems should have at least 20. 


>n 
where n represents the last of the files you created. 
4. Now remove all the tiles you created: 


rm * 


Your lost+ found directory is now set up. 


4.6 Setting Up User Accounts 


Now that you have set up file systems to make use of all your disk space, and assuming you 
have chosen a directory for the system's users. your system is ready to be set up for user 
accounts. 


Setting up user accounts involves the following elements: 
e Create a login directory under each user’s name. 
e Insert this name and certain parameters into /ete/passwd and optionally /ete/group. 
e Create a general .profile or .eshre file and copy it into each user’s directory. 
e Optionally create a general .login file and copy it into each user’s directory. 


e Optimize the .profile, .cshre, and .login files for each user’s account. 
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4.6.1 Create login Directories 


The following is the procedure for creating login directories: 


ii) 


Login as root. 


Change your working directory to the one in which you have decided to locate the 
users’ accounts: 


ed ./userdir 


where you specify the [full pathname to the user directory you have created. For 
example, if your user directory is /usr/user, type cd /usr/user. 


Create directories named after each person or account assigned to your system with 
the following command: 


mkdir username 


where username is the name of the person or account being created. For example, to 
create an account for someone named Fred in your user directory, you might enter 
mkdir fred. 


Repeat the previous command until you have created directories for everyone who 
will have login privileges to the system on a regular basis. 


4.6.2 Creating /etc/passwd and /etc/group Entries 


The following procedure describes how to conligure the /etc/passwd file as a part of creat- 
ing user accounts. 


1. 
2. 


Be sure you are logged in as root or become superuser. 
Change your working directory to /ete: 
cd /ete 


Make sure you are familiar with the /etc/passwd file and the information fields 
required for each entry. These are described in passwd(5) in the UNIX User's 
Manual, Vol. 1B. 


Invoke a text editor such as vi to open the /etc/passwd [ile. 
Create entries in /etc/passwd for each user name represented by a directory in step 3. 


Create and [ill in the appropriate tields (separated by colons) for each of these user 
entries. Below are two different examples: 


john::103:1:John Niswonger:/user/john:/usr/plx/csh 
tj::104:1:Theresa Jackson:/usr/user/therese:/bin/sh 


From these entries we see that john’s numerical userid is 103 and tj’s is 104; we know 
their real names to avoid confusion during turnover; John’s home login directory is 
/user whereas ‘Theresa's is /usr/user; and that John uses the “"C’’ shell while Theresa 
uses the standard, or Bourne shell. 
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NOTE 


When assigning userid numbers, start at 102 and progress 
from there. Userid numbers | through 101 are reserved for 
system use. 


Note that you do not enter anything in the password field itself (second from the 
left). That space gets filled with an encrypted password automatically when the indivi- 
dual user invokes the passwd(1) program as you did for root. If, for security reasons, 
you want passwords [or all users before they even log in, then successively login under 
each user name, invoke passwd, and create one for that account. The new user can 
change the password when (s)he logs in later. 


Write and quit (:wq!) the /etc/passwd file. 


If you plan to use group security as well, use a text editor to open /ete/group and add 
the entries and fields appropriate to your system use. Make sure you are familiar with 
the /ete/group tile and the information fields required for each entry. These are 
described in group(5) in the UNIX User's Manual, Vol. 1B. Write and quit this file. 
Tf you will not be using group-level security, ignore this step. 


4.6.3 Create -prefile and/ar .¢shre 


Creating and configuring .profile and/or .cshre files for the system’s user accounts saves 
much time and confusion when the users log onto the system and try to use it. Without 
one of these files, the users would have to specify the paths to each command they invoked, 
and some Berkeley-originated utilities would not work properly. Follow the procedure 
below to set up .profile and/or .cshre files. 


L. 


Create a model .profile for accounts logging into the /bin/sh (standard shell) environ- 
ment and a model .eshre for accounts logging into the /usr/plx/esh (‘‘C’’ shell) 
environment. Below are a sample .profile and .cshre: 


Sample .piSfile 


stty erase ""“h" kill ""x" echoe 
TERM=vt100 
PATH=:/usr/p1x:/bin:/usr/bin:/etc 
PS1="P35> " 

export TERM PATH P81 
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i) 


Sample .cshre 


setenv EXINIT ‘set aw wm=15 number redraw 
setenv TERM vt100 

setenv PATH .:/usr/p1x/:/bin:/usr/bin:/etc: 
setenv MAIL /usr/mail/username 

setenv TZ PSTS8PDT 

setenv SHELL /bin/csh 


stty erase “h’ kill ‘*x’° ixon echoe 
set history=20 
set prompt= 4% 


alias a alias 
alias h history 
alias lo logout 


Notice that the .eshre contains more parameters than the .profile because the Bourne 
Shell does not support aliases or the history function whereas the “C” shell features 
both. 


Also notice that the MAIL environment must specify the account’s actual user name. 


Copy your model .profile into each user directory that will use the Bourne shell as its 
environment: 


cp .profile userdir/. 
Repeat this command for each appropriate account. 


Copv your model .cshre into each user directory that will use the “C” shell as its 
environment: 


cp .cshre userdir/. 
Repeat this command for each appropriate account. 


Use a text editor to open each user's .profile or .cshre and specily the individual’s 
account name on the line specifying the MATL environment. 


Write and quit (:wa!) this file. 


(Optional) For accounts running “‘C” shell, you may want to create .login files as 
well as .eshre files. The difference is that the .login file sets parameters for the login 
shell only, whereas the .cshre sets parameters for all forked shells as well. The .login 
file is not necessary to system or user operation, however. Reler to the chapter, “An 
Introduction to the C Shell’? in the Svs3 UN/X Programmer's Manual, vol 2C for a 
more detailed description of the function of the .login file and suggestions for 
appropriate parameters. 


4.6.4 Changing Individual and Group Ownerships 


A basic UNIX principle is that anything you create is yours. [f you log in as root and 
create directories and files, all those directories and files belong to root. Since root set up 
login directories lor all the user accounts, root owns them. Now you (as root) must relinqu- 
ish the ownership of the relevant directories and files to the accounts designed to use them. 


Page 4-14 Plexus Computers 


P/35 User’s Manual Setting Up Your Installation 


Change ownerships of login directories and special files with the following procedures: 


1. 
2. 


4,7 


Make sure you are logged in as root. 
Change your working directory to the user directory. 


Change the ownership of each user’s home directory to the owner’s login name. 
Enter: 


chown username username 
For example, to give sam ownership of his own file, enter chown sam sam. 


Change the group (chgrp) of the user’s home directory to the group number of his 
line in /etc/passwd.: 


chgrp userno. username - 
For example, if sam’s userid number in /etc/passwd was 118, enter chgrp 118 sam. 


If you want each account to own his or her .profile, .cshre, and/or Avgin lile(s), 
change ownership of each of these files with chown and the standard syntax: 


chown username .profile 
chown username .login 
chown username .cshre 


assuming you have ed’d to the user’s login directory. 


If your terminals are properly connected and configured, your system is now ready to 
accept logins [rom everyone assigned to it. 


Modifying Maximum File Size 


To prevent large liles from being created by mistake (e.g. runaway processes) Sys3 includes 
a mechanism to limit the maximum size of any file which a process can create or access. 
The system default is set at 2 Mb. The system administrator may allow individual users or 
all users to create and access larger files. ‘he following procedure modifies the maximum 
file size limit for all processes on a system. 


3. 


Log in as root and position yourself in /ete. 


Enter the following C program and name it unlimit.c. 


long ulimit(); 
main (argc,argv,envp) 
int argc; 
char **argv: 
char **envp; 
execve("/etc/getty” argv.envp); 


} 


Compile this program using cc or ncc and place the executable file in /ete. The [ol- 
lowing is an appropriate command line: 
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ce unlimit.c -o /etc/unlimit 


4. Modily /ete/inittab. changing all references to getty to references to unlimit. The [ol- 
lowing sub-procedure will accomplish this. 


a. Create a backup copv of /ete/inittab: 
cp /etc/inittab /etc/inittab.bu 
b. Invoke a text editor such as ex or vi to edit /etc/inittab. 


c. Make a global substitution, replacing getty with unlimit in all instances that it 
occurs in the file. 


d. Write and quit this tile. 
5. Ask all users to log olf the system and bring it down with /ete/shutdown . 


6. Bring the system back up to multi-user mode as documented in the chapter, “Chang- 
ing System Initialization States”. 


When you execute the command ps -ef alter performing this procedure. all login ports 
which are not active will have /etc/unlimit displayed in the right-hand column 
instead of /etc/getty. Il this is not the case, or vou note that the process identilica- 
tion numbers are increasing rapidly and users cannot login, the unlimit program has not 
been installed properly. 


Check to see if unlimit.e compiled correctly and if the executable file is in /ete and has 
acceptable access permissions. Please note that you must repeat the last step of the above 
procedure to install any corrections. 


If you are unable to change the svstem file size limit successfully, restore the original conli- 
guration and call the Plexus Software Support Center. 


a. Run /ete/shutdown to bring the system down to single-user mode. 
b. Save the new copy ol /ete/inittab. 
Move your backup copy of inittab (/ete/inittab.bu) to /etc/inittab. 


d. Bring the system back up to multi-user mode. 
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CHANGING SYSTEM INITIALIZATION STATES 


As delivered, Plexus Sys3 UNIX is configured to run in any one of four system states. 
Each state is defined by what parts of the operating system are active at the time. 
Knowledge of what state your system is in is important because certain conditions require 
changing system states. The different states and the parts of the system that are active in 
each state are listed below: 


State Functions 
l System console only 


2 System console, all terminals, /éte/crad", /etc/opéMuP; 
fetc/update and /etc/eccdaeMen 


7 System console and /etc/update 


8 Autoboot* mode 


5.1 Finding the Curfent State 
During normal, multi-user mode, the system runs in state 2. 


If you are not in multi-user mode, you can find out what state you are in by entering the 
command: 
ps “Ff 


The resulting display has one line listed in the “command” column as INIT * where * 
is the system state number. 


Autoboot mode also requires that switch 3 (of the 8-position DIP switch) be set to ON on the main processor 
board (CPU). 
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5.2 Changing States 


The following procedures are described in this section: 


Going from state 2 to state | 
Going [rom state 7 to state | 
Going trom state | to state 2 
Going from state | to state 7 


Using state 8 


5.2.1 State 2 to State | via /etc/shutdown 


Sys3 UNIX provides a program called /ete/shutdown [or getting from multi-user mode 
(state 2) to single-user mode (state 1). It kills all the necessary processes in the right order 
and sends appropriate messages to active terminals. Perform the following steps to initiate 
a shutdown: 


l. 


i) 


Login on the console as root. You must be on the system console, in the root direc- 
tory. 
Enter: 
/ete/shutdown X 
where X = seconds of grace period (default = 60 sec) 


The program /etc/shutdown sends a series of messages to all active terminals, warning 
that the system will shut down in X seconds (the length of the grace period men- 
tioned above). 


The program takes several minutes to execute, during which time the user is 
prompted lor yes/no responses when necessary. When it asks: 


Busy out (push down) the appropriate phone lines for this system. 


Do you want to continue ? Center y or n) 
Hang up any modems and enter: 


y 


The system displays some messages, which may take a few minutes. It displays a list 
of processes (ps -eaf), then asks: 


Will a file save be done at this time (enter y or n). 
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The appropriate line in the list of processes should read: 
INIT i 
Respond by entering: 


NOTE 


If y is entered, /ect/shutdown displays the message: 


fsck will now be executed on files 
in checklist 


The complete fsck functions are completely displayed as 
described in the Plexus Sys3 UNIX Programmer's Manual. 


7. The system displays the message: 
Halt the system when ready. 


8. The system is now in state 1. It may be used in single-user mode, or shut down by 
pressing the RESET button on the system front panel or turning the SYSTEM 
POWER keyswitch to its off position. 

CAUTION 


If the system is used alter the shutdown program is finished, 
enter: 


sync ; sync 


before pressing the <reset> button or removing power. 


5.2.2 State 7 to State 1 
To get from state 7 to state 1, perform the following steps: 
1. Login on the console as root. You must be on the console, in the root directory. 


2. Enter: ° 


/etc/init 1 
3. Enter: 


ps -ef 
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4. Read the process number (PID) of /etc/update [rom the display. 
5. Use the command kill to kill /etc/update. Enter: 
kill -9 XXXX 
where XXXX is the process number (PID) of /ete/update. 


6. System is now in state 1. To verily. enter: 


ps -ef 
7. The command line of the display should read: 


INIT 1 


5.2.3 State 1 to State 2 
To take the system [rom state | to state 2 involves two simple steps: 
1. From the console, which is the only active terminal, enter: 


init 2 


The console displays: 


#cron started 
initializing ICPs 
Multi-user 

type ctrli-d 


Nm 


Type a character d while holding down the control (ctrl) key. 


The system should respond by sending login messages to all terminals. including the 
console. 


WARNING 


Plexus recommends that you always invoke fsck on all file 
systems while in init | before invoking init 2. 


5.2.4 State 1 to State 7 . 


Going trom state [ to state 7 is similar to the above procedure. On the console, enter: 
init 7 


The system starts /etc/update and sends a login message to the console. 
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5.2.5 Autoboot Mode (State 8) 


Sys3 has an autoboot feature, which causes the system to boot itself automatically after a 
system reset. Implementing autoboot involves setting switch 3 ON on the 8-position DIP 
switch on the CPU board. Detailed instructions for implementing this feature are in the 
Plexus P/35 Engineering Manual. 


When autoboot is running, the system runs in state 8 until the autoboot mode. automatically 
implements the multi-user mode (state 2). 


5.3 Shutting Down UNIX Gracefully 


Tf it becomes necessary to shut down your computer for anv reason (repairs, known power 
Outage, etc.), certain steps can be taken to protect it. This section describes the steps and 
provides instructions for their implementation. 


As shipped from Plexus, Sys} UNTX runs in one of four system states. Each state is 
defined by what parts of the system are operational at the time. The system can be shut 
down gracelully only from state 1. 


‘To shut down the system gracefully, use the following procedure: 
1. Using the procedures that appear earlier in this chapter take the system to state L. 
2. ‘To update the super-blocks and flush the system buffers. enter the command: 


syne ; sync 


CAUTTON 


The two syne commands must be the last items entered 
before the system is powered off. 


3. Set the keyswitch on the system front panel to its OFF position. 
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CREATING USER ACCOUNTS 


This chapter provides instructions for implementing the login TD and home directory 


required for each new user. 


Tt also provides two optional items: instructions for creating a directory where all users’ 
home directories will reside (necessary only on new installations where one does not already 
exist), and instructions for setting the users’ environments in their home directories. 


This section provides instructions which accomplish the stated tasks in one of many possible 
ways. For additional information, refer to the following items in the Plexus Sys3 UNIX 


Programmer's Manual. 


password 


group 


profile 


terminal type 


shell 


Plexus Computers 


Comman/Title 
passwd(1) 


group(5) 
cherp 


.protile(5) 
.cshre(5) 
login(5) 


termcap(5) 
ttytype(5) 


sh(1) 
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6.1 Procedure to Add a User 


A user must be equipped with a login ID and a home directory. To provide this, you 


must: 


a. Add a descriptive line in the ttle /ete/passwd 

b. Create a home directory. 

c. Assign that directory to the new user. 

The following procedure provides instructions for adding a new user. It also provides steps 
for creating a directory to contain the user’s home directories. 

1. Login as root or or become superuser. 


2. If there is no directory where users’ home directories reside. create one using the [ol- 
lowing steps: 


a. Access the directory root (/) by entering: 
cd / 
b. Enter the command: 


mkdir userdir 
NOTE: 


The name of this directory is a customer option. 
Throughout this section, the name user is used to represent 
the directory tn which users’ home directories reside. If 
these are in a directory with a different name. use that name 
in place of user. 


3. Using one of the editors, add a line like the following at the end of /etc/passwd: 


loginname::n1:n2:optional:/user/homedir: 


where: 

loginname is name by which the user will login 
is the field where an encrypted version of the user's password will 
appear alter the user selects a password. 

nl is the user number (use a unique number, 102 or greater for each 
user) 

n2 is the group number. Dividing users into groups requires colla- 
borating changes to the file /etc/group. In most cases the group 
number will be 10 or greater. 

optional ‘This space was created lor use by a system that is no longer sup- 


ported. Tt olten contains the user’s full name for information pur- 
poses. Tf not used. create an empty field by entering the two 
colons next to each other (::). 


/user/homedir is the pathname to the directory where the user starts alter logging 
in. The home directory usually (but not always) has the same 
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name as the loginname. 


shell is the field alter the last colon (:). It defines the shell that the user 
starts under alter logging in. If blank (like the example), it 
defaults to the standard (Bourne) shell (/bin/sh). 


EXAMPLE: _ The following line describes a user “‘sam’’. He is user 120 in 
group II, his full name is “Sam Jones”, his home directory is 
/user/sam and he uses the standard (Bourne) shell: 


sam::20:11:Sam Jones:/user/sam: 
Alter he selects his password, the line may look like this: 
sam:2/xyzsP:20:11:Sam Jones:/user/sam: 


Move to the directory /user and create a home_directory (this directory usually has 
the same name as the user’s loginname). 


EXAMPLE: mkdir sam 
Change the owner of the directory "home_directory” to "loginname". 
EXAMPLE: chown sam sam 


Change the group (chgrp) of the user’s home directory to the group number of his 
line in /ete/passwd. 


EXAMPLE: chgrp I! sam 


6.2 Setting the User’s Profile 


The user’s environment can be controlled by creating a lile called .prolite in the user’s 
home directory. UNIX automatically scans for .profile in the user’s home directory and 
implements the commands there every time the user logs in. While a number of things can 
be done with .profile, only these three basics are covered here: 


1. 


Set the command path -- When a user enters a command, UNIX looks for the com- 
mand in the places specified in the user’s command path. 


Set the terminal type -- UNIX needs to look up information about the user’s terminal 
type tor certain UC Berkeley-originated utilities. 


Export the command path and terminal type (PATH and TERM) -- This makes the 
information available to other shells. 


The following ts an example of the contents of a .profile file: 


PATH=:/usr/p1x:/etc:/user/sam/bin:/bin:/usr/bin 
TERM=vtioo 
export PATH TERM 


6.2.1 Command Path 


The command path ts the first line in the .prolile example. When a user enters a command 
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that is not part of the standard shell, UNIX searches in all the directories in the command 
path until it finds the command. 


The tormat of the command path line is: 


PATH=: /xxxx/xxxx:/yyyy/yyyy :/z2zzz/zzzz 


where the colon (:) is a lield separator that separates the different path names. 


NOTE 


To avoid’ contusion, remember that in this section, it Is 
assumed that all users’ home directories reside in the direc- 
tory /user. his is not true of all installations; substitute the 
proper name for the word user if another directory name Is 
used. 


A typical system has commands in /usr/plx, /etc, /bin and /usr/bin. Commands and shell 
procedures created especially for /user/sam usually go in /user/sam/bin. Belore /user/sam 
can execute the commands in these locations, the pathnames must be specilied in his .pro- 
file file. 

Other directories can be added to the path list. For example, if Sam wanted to use the 
commands in Sara’s bin. he could add /user/sara/bin to his path list. However, there is a 
cost in system resources; UNIX scans every location in the path list whenever a command is 
entered. To promote elliciency, keep the path list as short as possible and order the direc- 
tories so that the most often used appear earlier in the list. 


To initialize the changes to .protile. enter the command: 


sh /user/home_directory/. profile 


EXAMPLE: sh /user/sam/.profile 


6.2.2 Terminal Type 


Because of the dillerences between terminals, some of the UC Berkeley programs need to 
know what type of terminal they will interface. Two files contain this information: 
/etc/termeap and /etc/ttvtype. 


The file /ete/termeap lists all the common terminal types and provides some code to deal 
with their various dilferences. The file /ete/ttytype is a list of system ports, which details 
the terminal type attached to each port. It is keyed to /ete/termcap; the terminal names in 
/etc/ttytype are used to access the data in /ete/termcap. 


There are two ways to make this information available to .profile. If the user will be work- 
ing from only one terminal type. add the following line to the .prolile file: 


TERM = termtypeXXXX 


where termtypeXXXX is one ol the terminal names provided in /ete/termcap (some termi- 
nal types have many names in /ete/termeap). 
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For users who regularly switch terminals. add the line: 
TERM = ‘tset 


The tset command looks up the terminal type in /ete/ttytype and enters that name in the 
space between the accents. Use the grave accent (-), not the single quote (’). 


6.2.3 Exporting PATH and TERM 


To make the command path (PATH) and terminal type (TERM) available to other shells. 
add the line: 


export PATH TERM 


to the .profile file alter the lines lor command path and terminal type. This appears in the 
example ol a .protile file earlier in this section. 
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ADDING PRINTERS 


This chapter provides information required to configure the appropriate software files when 
connecting printers to a Plexus computer. The procedures include how to connect a printer 
to the spooler, how to reassign the spooler to another port, and how to connect an addi- 
tional printer to a port without a spooler. 


All printers attach to the system I/O panel, which is described and illustrated in the P/35 
Installation Guide. 


Pinouts of the RS232C serial connectors and the Centronics-type parallel connector are 
listed in Tables 7-1 and 7-2. 


7.1 Using the Spooler 


Sys3 UNIX provides a spooler to queue print requests to a single parallel port (the default 
is parallel port 0). Other ports can drive printers. but there is no queueing capability unless 
the spooler is reassigned. 


In the default spooler configuration, files piped to Ipr are queued and printed in the order 
they are received on the special file /dev/Ip, which is assigned to parallel port 0 in ICP 1. 
To use this spooler at its default location, attach the printer cable to PAR 0 on the system 
V/O panel. 
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TABLE 7-1. Serial Printer Pinout Connections 


Serial Connector Signals (RS232 Standard) 


Description 


| (not used) 

2 Transmitted data TO dce* 

3 Received data FROM dce 
4 Request to send TO dce 

5 Clear to send FROM dce 
6 Data set ready FROM dce 
7 Signal ground (common return) | (not applicable) 
§ Carrier detect FROM dce 
9 (not used) 
10 (not used) 

ll Speed select TO dce 
{2 (not used) 
13 (not used) 
Id (not used) 
15 Transmit clock FROM dce 
16 (not used) 


Receive clock FROM dce 
(not used) 

(not used) 

Data terminal ready 
(not used) 
(not used) 
(not used) 
(not used) 
(not used 


TO dce 


“dee = data communication equipment. 
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TABLE 7-2. Parallel Printer Pinout Connections 


Parallel Connector Signals (Centronics Standard 


Signal Interface 
Name Pin# Source : 


DATA STROBE/ 1.19 Processor | Pulse clocks data to printer 

DATA | 2,20 Processor | LSB ) 

DATA 2 3,21 Processor ) 

DATA 3 4.22 Processor j 

DATA 4 5,23 Processor ) LOW = 0 

DATA 5 6,24 Processor ) HIGH = 1 

DATA 6 T25 Processor ) 

DATA 7 8,26 Processor ) 

DATA & 9,27 Processor | MSB ) 

ACKNLG/ 10,28 Printer Acknowledges receipt of 
character or end of func- 
tion 

BUSY 1129 Printer [NOT USED] 

PE 12 Printer Out of paper 

SLCT 13 Printer Printer selected 

Gnd i4 Printer Signal ground 

Gnd 16 Signal ground 

INPUT PRIME/ 3130 Processor | Initializes printer 

FAULT? 32 Printer Printer fault 


NOTE |. Second pin number (number after comma) indicates 
the ground wire of a twisted pair return. 
NOTE 2. The symbol / indicates "negative true" (i.e. logical NOT). 


7.2 ReassighiNy the Spooler 


To assign the spooler to another port, you must remove the file /devitb and link the name 
/dev/\p to the device file of the new port. The following procedure shows how: 


1. Login as root or become superuser. 
2. Remove the file /A&v/Ip. by entering: 
rm -f /dev/Ip 
3. Link the device file of the new port to /dev/IB. Enter either: 


In /dev/ttyxx /dev/Ip — for serial port 
or 
in /dev/ppx /dev/lp — lor parallel port 


where x and xx stand for the device numbers. 


4. If you are adding a serial printer, complete the procedure “* Adding a Serial Printer” 
in this section. A parallel printer need only be connected to a parallel port on the 
system I/O panel. 
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7.3 Assigning a Printer with No Spooler 


Yo connect a printer to a port with no spooler, link the port’s device file to another device 
file (/dev/name). Requests to print to the new device file go to the port having a device file 
linked to it. 


Use the following procedure: 
1. Login as root or become superuser. 
2. Change vour working directorv to the device directory: 
cd /dev 
3. Link the device number to the device name by entering: 


In /dev/ttyxx /dev/name -- lor serial ports 
or 
In /dev/ppx /dev/name -- for parallel ports 


where x and xx are the device numbers, and name is the name used to identify the 
port lor print requests. 


For example. connecting an NEC Spinwriter* to ttyl2 could translate in to the com- 
mand, In ‘dev/tty12 /dev/nec. which links serial port 12 to /dev/nec. To print a file on 
this port, direct output to /dev/nec. 


+. Tf a serial printer is being added. complete the procedure in “Adding a Serial 
Printer” in this section. A parallel printer need only be connected to a parallel port 
on the system I/O panel. 


7.4 Adding a Serial Printer 


Any serial I/O port can drive a serial printer. Because only one spooler is implemented, 
additional printers must be used carefully; overlapping requests to print on a port without a 
spooler port will cause unacceptable results. 


Because of the flexibility of UNIX serial ports, certain parameters must be set before a 
serial printer can be attached to a serial port. The following procedure shows how: 
1. Modify /ete/inittab. 


Serial printers must be connected to non-login (i.e. output) ports. The /ete/inittab 
flag for a non-login port is an “oO”. Reler to the Sys3 Programmer's Manual, Volume 
2B, Section 5, for a description olf /ete/inittab. 


Edit file /etc/inittab to set the flag for the printer port correctly. The third informa- 
tion field should be an “0” instead of a “c’’. For example: 


2:03:0:/ete/getty tty3 b 


NEC and Spinwniter are trademarks of Nippon Electric Corporation. 
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2. Modify /ete/re. 


The characteristics of the serial port must be set to support the speed and capabilities 
of the serial printer. 


a. Open the port. 


The port must be opened to set the line characteristics appropriately and must 
remain open lor the characteristics to be maintained. Port characteristics are 
reset each time the line is closed. 


The port may be opened and kept open by executing the “openup” program. 
The port is identified as an output port (write only) with the "-w" tlag followed 
by the path name to the desired port. 


Parameters may be added to the openup command included in /ete/re or 
another openup command may be added to the file. Note that each openup 
command can accept only 10 parameters (devices, directories, or files). 


Tf you relink the port so that it can be referenced by another name, such as 
"Ip", you may reler to the port by that name in the openup command. Below 
are examples: 


/etc/openup -w /dev/tty3 
/etc/openup -w /dev/Ip 


b. Set port characteristics. 
Port characteristics are set with the stty command and/or a program. 


[1] One or more stty commands should be placed alter the openup com- 
mand in the /ete/re file to set the baud rate (unless the default speed of 
9600 baud is acceptable) and other port characteristics. Reler to the 
Sys3 Programmer's Manual, Volume 1A, stty(1) to select the charac- 
teristics you need to support your serial printer. 


The following commands support the majority of serial printers in use: 


stty sanl® </dev/ttyxx 
stty 1200 -echo -tabs onler </dev/ttyxx 


To enable flow control based on a CTS (clear to send) signal, set the icts 
flag instead of the ixon flag. Note that you may have to disable ixon if 
it has been set by a stty sane command. 


In Sys3 revisions 3.0 and later icts may be specilied as a parameter to the 
stty command. Previous revisions require setting the ICTS flag in a pro- 
gram which must be executed after the openup command. A sample 
program is included at the end of this chapter which includes the 
sequence required to set ICTS. 


If you are going to use [low control based on a CTS signal, rejumper the 
ICP to recognize the signal on either pin 4, 11, or 20. 


(a) Shut down the system and remove the ICP board. 


(b) Locate the port’s 10-pin jumper network. Refer to the figure titled, 
“ICP Board Option Selectors’, in the P/35 Engineering Manual. 
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(c) Using the jumper placed between pin pair 3 and pin pair 4 by 
default. jumper pin pair 1, 2, or 3 depending on whether the CTS 
signal is provided to the 25 pin connector on pin 20, 11. or 4 
respectively. 


Additional documentation on the purpose and jumpering of each pin 
pair is available in the P/35 Engineering Manual in the section. ““Conli- 
guring an ICP” 


A program ts used to set port characteristics whenever stty does not pro- 
vide the desired capabilities. The program may be invoked by the 
/ete/re script immediately alter the openup on the port or after the last 
stty referencing the port. The following example sets the ICTS flag and 
mav be used as a guide to setting other tty flags: 


/* This program utilizes the "flow-control" features «/ 
/* of the Plexus ICP and its’ software. It should be */ 


/*x invoked by 


“fetc/re° after the ‘openup’ statement. */ 


#include <errno.h> 
#include <sys/param.h> 
#include <sys/tty.h> 
#include <sys/ioctl.h> 
#include <stdio.h> 


int errno, 
main () 


{ 


struct termio buf; 


int fd; 
char cc; 


fd=open("/dev/tty??",2); /* replace ?? with the port number */ 


if (fda<o) { 


perror(“error\n") ; 


exit (1); 
} 


ioctl (fd, TCGETA,&buf) ; 


buf .c_iflag [= 


IcTSs; 


ioctl(fd,TCSETA, &buf) ; 
ioctl(fd,TCGETA, &buf) ; 
printf ("%o\n#o\nho\nFo\n", buf. c_iflag, buf.c_oflag, 


} 
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CONFIGURING DISKS 


Configuring disks for a Plexus system involves two separate software utilities, deonfig and 
mkfs. dconfig is a Plexus utility that defines the disk space by logical disks allocated in 
512-byte sectors. mkfs is a UNIX utility that sets up the file systems in 1K blocks which 
are integral to the operation of UNIX. File systems are composed of the file space itself 
plus pointers and file definition information which enables UNIX to find and use the files. 


The two levels of software are joined by the UNIX utility, mknod. which specifies which 
logical disks and their start addresses listed in deonfig will be created and utilized in 
UNIX’s device directory, /dev. Another UNIX utility, mount, attaches a specified directory 
hierarchy to a specified file system. 


The following diagram illustrates the roles of deonfig and mkfs in organizing and utilizing 
disk space. Boundaries marked by double lines (=) are established by deonfig; single-lined 
boundaries illustrate the organization of file systems as established by mkfs. 


As the diagram shows, deonfig establishes the starr addresses of each logical disk, the swap 
address and length, and the logical device upon which the swap space resides (which in this 
case, is /dev/dk1). (deonfig establishes several other parameters as well which are docu- 
mented in the chapter, ‘The Standalone Environment.”’) 


As the diagram also shows, mkfs sets up the boundaries illustrated by the single lines — the 
internal organization of each file system — plus the length of each file system. Ordinarily, 
dconfig does not set up discrete lengths for the logical disks. It is instead handled by mkfs 
at the file system level. 


Optionally, however, deonfig can also establish discrete upper boundaries for each logical 
disk, but does not do so by default except for /dev/dk!. Rather, all other logical disks have 
the same upper boundary, the end of the physical disk itself. 
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block 
0 information block 
1 superblock 
2 
i-list 
2+ i-size 
data, 
indirect, 
and free 
blocks /dev/dk1 
swplo 
Swap Area 
nswap 
file size 
0 information block 
I superblock 
2 
2+ i-size /dev/dk(1 +n) 
data, 
indirect, 
and free 
blocks 
filesize 


Figure 8-1. dcontig and mk{s Control Parameters 


The two levels are joined by mknod as indicated by the syntax of this command. Below is 
an example: 


mknod /dev/dk3 b 0 3 


Use the mknod command to create and define a logical device in the UNIX device direc- 
tory, /dev. In this example, the device is logical disk dk3. It is a block device (‘"b’’), major 
device number 0, and has been assigned minor device number 3. You must mknod the 
logical device before you proceed to attach a file system to it via mkfs. 


Then use the mkfs command to create a file system affixed to the same start address as the 
specified logical disk (in this case /dev/dk3) and specify the file system length in 1K blocks 
(in this example, 20000): 
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mkfs /dev/dk3 20000 mn 


where m is the interlace factor (all P/35 disks have an interlace of 1 as of this printing) and 
n is a blocking factor constant which ts 500. 


For example, if a disk had an m of 7 and an n of 500, the disk would write to every 
seventh sector for 500 writes, and then return to the next to the lirst sector and repeat the 
pattern six more times until the first 3500 blocks have been used up that way. The logically 


contiguous sectors would occupy physical sectors 1, 8, 15, 22, . . . 3495, return to write to 
blocks 2, 9, 16, 23, . . . 3496, etc. until the last pass in that section would occupy sectors 7, 
14, 21, 28, . . . 3500. Then the next group of logical sectors would occupy 3501, 3508, 


3515, etc. and repeat the pattern until sectors 3501 through 7000 were occupied as well. 


Finally, use the mount command to attach the lile system/logical device to the directory 
hierarchy of your choice. For example, if you wanted /dev/dk3 to hold your printer spooler 
you would enter: 


mount /dev/dk3 /usr/spool 
Thus, the basic sequence for configuring a disk requires you to: 


a. Determine how you want to split up your disk(s). Each logical disk must be con- 
tained within a given physical disk; 1.e., logical disks and file systems cannot span the 
boundaries of the actual physical disks upon which they reside. 


b. Run dconfig to ensure that the default values are sufficient to your goals, and if not, 
change them, specifying the addresses and lengths in 512-byte sectors. 


c. Run mknod to create logical disks in /dev. These logical devices must correspond to 
the start addresses you picked or established when running dconfig. 


d. Make the file systems via mkfs which assigns the lile systems to the logical disks you 
created via mknod and specifies the file system length in 1K blocks. 


e. Create or assign UNIX directories for the logical disks/file systems you just created 
via mkdir. 


{. Mount the file svstems to the directories via mount. 


This chapter provides the following procedures involved in configuring disks: 
e Creating multiple or mounted file systems 
e Changing the size and/or location of the swap area 


e Configuring the software when installing an additional disk drive 


8.1 Creating Mounted File Systems 


Plexus systems are shipped with /dev/dkI activated, created in the device directory, esta- 
blished via mkfs, and occupied by the Sys3 root file system. That still leaves the rest of the 
disk(s) to be configured for your installation. Plexus has also created logical disk /dev/dk2 
in the device directory; default values in deonfig dictate that it extend over the rest of the 
disk. /dev/dk2 does not have a usable file system until you make one with mkfs and mount 
it to a directory. The size of the /dev/dk2 file system — or any [ile system that extends to 
“end of disk’? — depends on the size of your disk. The [following table shows the size of 
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the default /dev/dk2 lor typical disks: 


TABLE 8-1. Default Sizes (in blocks) for /dev/dk2 


Old New 


Disk Size IMSP (pd) _ IMSP (pd 
22 Mb 8" 3 43 
36 Mb 8" 13405 9405 
72 Mb 8" 47473 43473 
142.6 Mb 8" —-116272 112272 
72 Mb 14" 48085 44085 
145 Mb 14" 116170 112170 

| 289 Mb 14” 261120 257120 


You may leave /dev/dk2 as is and create a file system for it and mount it. Assuming you 
are already satislied with /dev/dkl and the size and location of the swap area. your disk 
conliguration task would then be finished. With smaller disks, this is usually satisfactorv. 


Certain circumstances, however. dictate that you further delineate the disk space between 
the end of dk! and the end of the disk. Particularly, you should keep each file system at 
least slightly smaller than your tape backup capacity. For open-reel 9-track tape. you can 
archive approximately | Mb tor every 30 feet of tape if you are using a low-overhead utility 
such as dump or fhackup. At this rate, you could get up to 80 Mb on a 2400-foot reel of 
tape. Cartridge tape drives have smaller tape capacities as follows: 


System Capacity 


Cartridge drives shipped prior to June 1984 20MB 


Cartridge drives shipped alter June 1984 45MB 


An advantage of smaller file systems is faster disk I/O because the operating system does 
not have to search through an extremely large disk area. The disadvantage is that it 
requires more dump or fbackup operations to backup the entire disk. 


To figure the remainder of your disk you must determine exactly how long each file system 
can be and which dk numbers in deonfig provide the correct sector start addresses. This 
second factor is required so you know which logical disk numbers you should create in /dev 
upon which to mount file systems. 


The general procedure for conliguring the remainder of the disk is contained in the 
chapter, “Setting up Your Installation” and is not reproduced here. This section, however, 
takes a specilic example and shows exactly how the general procedures in the other section 
apply to a specific case. 


In our example. let us say you have a “new” (i.e. 6 MB swap) P/35 with an 8" 72 Mb disk 
drive and you want to create two file systems beyond /dev/dkI of approximately equal size. 
According to Table 8-1, the rest of your disk beyond /dev/dkI is 43473 blocks, or 86946 
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sectors. Io subdivide /dev/dk2 into two parts of approximately the same size and yet make 
use of the factory set sector start addresses, you could make /dev/dk2 20000 blocks (40000 
sectors). That leaves a remaining space of 23473 blocks or 46946 sectors. Reproduced 
below are the default start sector addresses for dconfig’s dk numbers: 


TABLE 8-2. Delault Start Sector (512 byte) Addresses 


Pre-Sys3 3.2 

and 22Mb P/35s New P/3S5s 
dkO = [0,0]: 0,” 0, 
dk1 [0,0]: 0,40000 0,48000 
dk2 [0.0]:  40000,~ 48000," 
dk3 [0,0]: 60000,” 68000." 
dk4 [0.0]: 80000, 88000,” 
dk5 {0,0}: 100000,” 108000," 
dk6 [0.0]: 120000,” 128000,” 
dk7 {0.0}: 140000,” 148000,” 
dk& [0,0{: 160000,” 168000," 
dk9 = [0,0]: 180000,” 188000," 
dk10 [0,0]: 200000,~ 208000," 
dkil [0,0]: 220000,” 228000," 
dk12 [0,0]: 240000,” 248000, 
dk13 [0,0]: 260000," 268000," 
dk14 [0,0]: 280000,” 288000," 
dkI5 [0,0]: 300000,- 308000," 


Default Start Sector (512 byte) Addresses 


As you can see from this second chart, dk2’s starting sector address for this system is 
48000, and its default length is 43473 blocks which translates into 86946 sectors. In such 
case, you could assign 20 Mb (20000 blocks or 4000 sectors) to /dev/dk2. That means the 
starting sector address of the last file system would begin at sector address 88000, which is 
dk4. This would then mean that the third logical disk you added to /dev would be dk4, and 
its length would be 23473 blocks (43743 blocks minus 20000 blocks assigned to dk2) speci- 
lied by running mkfs. The entire sequence to set up a disk this way is shown below. 
Further, let us say that the two logical devices created will be the user directory and the 


spooler. 


1. Be sure you are logged in as root. 


iw 


If you are merely altering the sizes of these files, make sure you can backup the data 
that is currently on these [ile systems first. and that they will fit into the new file sys- 
tems you will be creating. 


3. Change your working directory to the device directory by entering: 
cd /dev <return> 


4. As shipped [rom Plexus, your device directory already contains dkO, dk1, and dk2. 
You will need to add dk4. 
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5. 


9. 


Create a logical block device for /dev/dk4 by specifying the following: 
/etc/mknod /dev/dk4 b 0 4 


where b is a block device, 0 is the major device number, and 4 is the minor device 
number. 


Create raw devices for each of the logical disk devices you created in the previous 
step: 


/ete/mknod /dev/rdk4 c 3 4 


where c is a “character” (raw) device, 3 is the major device number, and the last 
number is the minor device number (it corresponds to the rdk number). 


Now create the file svstems to correspond to these logical devices, assigning the sizes 
established in the introduction to this procedure. 


/etce/mkfs /dev/dk2 20000 mn 
/ete/mkfs /dev/dk4 23473 mn 


where m is the sottware treeblock interleave and n ts 500, the blocking constant as 
explained in the beginning section of this chapter. You need not specily the m and n 
parameters with any standard P/35 disk configurations through Sys3 version 3.3, but 
the information is provided so you know what is actually happening when you run 
mkfs. Also, other Plexus computers require specifying the m and n factors when run- 
ning mkfs. 


The spooler already exists as /usr/spool, but vou must still create the user directory: 
/ete/mkdir /user 


Mount the logical block devices to the directories you created or chose in the last 
step: 


/etc/mount /dev/dk2 /usr/spool 
/etc/mount /dev/dk4 /user 


Change your working directory to /ete: 
cd /ete 


Invoke a text editor such as vi to open the file, /ete/re. Add /ete/umount commands 
and /ete/mount commands for the /dev/dk2 and /dev/dk4 you established in the previ- 
ous steps. Figure 8-2 is an illustration of the sections of /ete/re you will alter. Sample 
additions are shown in bold. 


Page 8-6 Plexus Computers 


P/35 User’s Manual Configuring Disks 


12. 


13. 
14. 


15. 


# fatc/re curstate no.-times-prev-in-curstate prevstat 
TZ=PSTSPDT 


export TZ 

( 

case ${1-2} in 

1) 
uname 
echo single-user 
af (€ "$2" != 0 ] 
then 


put umounts here 
7®tc/umount /dev/dk2 
/etc/uBount /dev/ak14 
£1 
'4 
217) 
iz [ "$2" = 0] ; then 
cp /tmp/EX* /tmp/Rx* /uSr/preserve 2>/dev/null 
rm ~f /tmp/* /usr/tmp/* /etc/utmp 
fi 
af ({ "$2" = zo "82" = mH -6 n$33n = 1 ] 
then 
echo ‘initializing IMSP’ 
sync 
sleep 3 
/etc/dnid -dd -a 5000000 -f /usr/lib/dnid/imsc -o /dev/imo 
/etc/devnm / {| grep -v swap | grep =v root | /etc/setmnt 
put mounts here 
/ete/usount /dev/adE2 
/®tc/uBoutt /dev/akEi4 
/etc/update 
rm -f /usr/adm/acct/nite/lock* 
if [ "$1" = 2) ; then 
# /bin/eu = adm -c /usr/lib/acct/startup 


. etc. 


Figufe 8-2, Inserting mounts and umounts tn /etc/rc 


Write and quit this file. 


It is more convenient and safer for the system to automatically perform a file system 
check on all active file systems when you invoke fséK in single-user mode. To do so, 
invoke a text editor such as vi to open the file, /etc/cheéKlist. Insert the logical dev- 
ice names you want checked. For example, the /€te/checklist corresponding to the 
/etc/re in the previous step would look like this: 


/dev/dki 
/dev/dk2 
/dev/dkA 


Perform fsck on each of the new file systems to ensure their integrity. 


Shut down the system gracefully (see the chapter, “Changing System Initialization 
States’). 


Reboot the system and bring it up multi-user as described in the section, “Booting 
from Disk.” 
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8.2 Increasing the Swap Area 


If you experience problems with swap area size, you should increase the size of the swap 
area. The following system messages are symptoms of swap area problems: 


e No more processes 
°® Sys3: panic: out of swap space 
® Cannot fork 


To increase the swap space, follow the general procedure below. Examples of individual 
methods follow the general procedure. 


1. Determine Auw large you want the swap area. As a general rule, the bigger the 
better; but you must also consider how much free space is available, and how much is 
required for other purposes. 


The factory setting size, beginning with Sys3 3.2, is 6 Mbytes; this is adequate for 
most sites. 2 Mbytes, the former default, is usually inadequate; 10 Mbytes is gen- 
erous in most cases. For a more accurate accounting of your swap needs, refer to the 
section, “Determine Swap Space” in the chapter, “System Administration Considera- 
tions.” 


Ww 


Determine where you want the swap space. Usually you want it on the root file sys- 
tem, which is /dev/dkI by default. But even a moderately large swap area at the end 
of /dev/dk1 overlaps the starting address of the space assigned for /dev/dk2 (see Table 
5-1). Therefore, some users choose a 10 Mbyte /dev/dk2 for the swap area. 


Note that in the course of changing the size of the swap area, you might change the 
logical disk boundaries. If this happens, you must back up (using dump) and remake 
(using mkfs) any other file systems whose boundaries have changed. 


If you will change file system boundaries, make a chart of the new boundaries, 
including starting and ending addresses in sectors (512 bytes), to use as an aid in the 
steps that follow. 


3. Back up any file systems whose boundaries will change as a result of changing the 
swap area. Use dump(1M). 


4. Run deonfig to change some or all of the following parameters: 


Swapdev The file system containing the swap area. If you want the swap area on 
fdev/dk1, and /dev/dkl is your root file system, you don’t need to 
change this. 

Dumpdev Should be the same as swapdev. 

Swplo The starting address of the swap area. This must be in 512-byte sectors 
(not 1024-byte blocks). 

Nswap ‘The number of sectors to be used [or the swap area. 

dk The new logical disk boundaries. 


5. ‘Type syne if in single user mode. 
6. Reboot the system. 


7. Using mkfs, re-create the file systems you previously dumped to the new sizes deter- 
mined by reallocating the swap area. 
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8. Restore those file systems from the dump tape and mount them. 


8.2.1 Examples 


Configuring Disks 


Three approaches are typically used to increase the size of the swap area. The first extends 
dk1; the second uses dk2 as the swap area. and the third creates one logical disk only and 
places the swap area at the end of the disk. (This last approach is most useful for 36 Mbyte 


disks.) 


Plexus recommends that you use one of the first two methods so that the logical file system 


configuration is 


as close as possible to the default file system configuration. 


8.2.1.1 Extend dkl 


1. Back up any tile systems whose boundaries will change. 


2. Enlarge the swap area to 6 Mbytes and place it at the end of dk1I by running deonfig 
with these parameters: 


Rootdev 1 
Pipedev 1 
Dumpdev 1 
Swapdev 1 

Swplo 36000 
Nswap 12000 
dkO 0,7 

dk1 0,48000 
dk2 48000," 


NOTE 


When you first view dconfig, the values in the default logical 
device configuration table (the table where the sizes of the 
dk devices are defined), are shown as zeroes. In an unaltered 
deonfig file, these zeroes signify that the default values have 
not been changed. If, however, you change one sector start 
address or logical disk length, dconfig will then assume that 
all displayed values are literal, i.e., that all other logical 
disks are located at offset zero and are zero length. 


Therefore, if you change any start sector addresses in the 
default logical device configuration table you must adjust any 
other dk offsets and file system lengths that you intend to 
mknod, and mount. Otherwise these logical disks would 
have zero lengths. 
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You must also adjust other dk offsets and lengths to avoid 
having one file system overlap into the start address of 
another. For example, if your dk2 is presently 20 Mb and 
you want to keep it that size, you also plan to use dk4, and 
you change dk2’s start address from sector offset 40000 to 
48000, you would then need to also change the sector offset 
of dk4 from 80000 to 88000 so the 20 Mb length of dk2 did 
not overlap dk4. 


Exit deonfig 
Update the superblock by entering 
sync ; sync 
Reboot the system, bringing it up multi-user. 


Remake (mkfs) and restore (from a backup tape) any file systems that you altered 
while in dconfig 


8.2.1.2 Use dk2 as Swap Area 


1. 


2. 


Back up any file systems whose boundaries will change. 


Make a !0 Mbyte swap area using dk2 by running deonfig with these parameters. 
This example works lor 72 Mbyte disks or larger. 


To make a !0 Mb swap area out of dk2, key in the following values when running 
dconfig. 


Rootdev 1 

Pipedev 1 

Dumpdev 2 

Swapdev 2 

Swplo 0 

Nswap 20000 

dkO 0. 

dk1 0,40000 
dk2 40000,20000 
dk3 60000, 


NOTE 


BE SURE you have backed up anything that was previously 
in dk2. You will move this data to another available file sys- 
tem later. 


Note that if you change any entries in the default logical device configuration table in 
dconfig (the table where the sizes of the dk devices are defined), you must change any 
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other dk device sector offsets that are affected by the changes. 
3. Exit dconfig. 


4. Delete the device file, /dev/swap, and remake it (using mknod). Note that this step 
is necessary ONLY if you are placing the new swap area on a [ile system other than 
dk1. Follow these steps: 


mknod /dev/swap b 0 2 


Make sure to do the mknod before you shut down the system before rebooting to use 
the new swap area. 


5. Update the superblock by entering: 
syne ; sync 
6. Reboot the system. 


7. Remake (via mkfs) and restore (from your backup tape) any file systems affected by 
the device and boundary changes. 


§.2.1.3 Create a Single Logical Disk (36 Mbyte Systems) 


To make a 36 Mbyte disk one {ile system with the swap area at the end of the disk, follow 
these instructions. 


First do a level 0 dump to back up the entire dkl. Back up dk2, if it exists, with tar or 
cpio. Check the tar or cpio tape by reading it back with the “t” option, 


Then run deonfig. Change the following parameters: 


Rootdev l 
Pipedev 1 
Dumpdev l 
Swapdev 1 

Swplo 54800 
Nswap 12000 
dkO 0, 

dk} 0.66800 


BE SURE you have backed up anything that was previously in 
dk2. You will move this data into dk1 later. 


Type “sync’’, reboot the system, and make a new [ile system at /dev/dkl by typing 
ntkfg /dev/dk1 27400 
Finally, restore the dump of dk1 and the tar or cpio backup of dk2. 


8:3 Configuring a Secehd Disk PFve 


Configuring a second disk drive involves the same general steps and file modification pro- 
cedures as those performed for the original system disk, In both cases, you: 
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1. Decide how you want to divide the physical disk into logical disks and file systems. 


Io 


Choose the logical disks in deonfig that contain the sector offsets you need to divide 
up the disk according to your plan. 


3, mknod the logical devices in dev to correspond to the sector start addresses you chose 
in dconfig. 


4. mkfs the file systems and specily their sizes. 
5. mkdir or choose the directories that will become [ile systems. 
6. mount the chosen directories to the logical devices you created in dev (via mknod). 


The main difference is that running dconfig is much simpler for add-on disks. Whereas 
setting up the original system disk required you to run dconfig to allocate swap space and 
designate the device number for the root file system and its system-intensive parameters, no 
such configurations are necessary for add-on disks because they add storage space and noth- 
ing else. Parameters such as Nswap, Swplo, Swapdev, Dumpdev, Pipedev and Rootdev 
should all be set to zero because the Sys3 does not use add-on disks for these functions. 


You may not even need to run dconfig at all for add-on disks, because the default values 
will probably be sulficient to your purpose. You will, however, need to know the sector 
start addresses for each logical disk (dk number) so you can choose the appropriate ones to 
mknod and mount. 


Plexus’ dconfig is set up such that each physical disk is divided into 16 logical disks. The 
first one starts at sector offset zero (0) and extends to the end of the disk. The second logi- 
cal disk also starts at offset zero and is 20 Mb long (except for systems shipped with Sys3 
3.2 or later, in which case the factory has reset dk1 to 24 Mb on P/35s with 36 Mb-and- 
larger disks). Starting with the third logical disk, each of the rest of the logical disks starts 
at a sector offset 10 Mb (20000 sectors) higher than the previous one. 


When vou are in dconfig, regardless of the physical disk, dconfig always prompts for logical 
disks 0 through 15. As far as Sys3 is concerned, however, dkO through dk15 reside on the 
first disk. dk16 through dk31 reside on the second disk, dk32 through dk47 reside on the 
third disk, and dk48 through dk63 reside on the fourth disk. The four disks are numbered 
0 through 3. You must know the ranges of dk numbers for each of the physical disks so 
you can create the correct logical devices in the dev directory. 


Standalone deonfig knows the four disks as pd(0.0); pd(1,0); pd(2.0); and pd(3,0). The 
Sys3 version, ete/dconfig, knows the four physical disks as /dev/dkO, /dev/dk16, /dev/dk32, 
and /dev/dk48. 


The sector start addresses for the logical disks within each of the four possible physical disks 
are displayed in Table 8-3. 


Page 8-12 Plexus Computers 


P/35 User’s Manual Configuring Disks 


TABLE 8-3. Add-on Disk Start Sector Addresses 


diskO — diskI ~— disk2 ~— disk3 Sector Offset, Length 
dkO dk16 = dk32) ss dk48 [0,0]: 0,7 

dk1 dkt17  =dk33— dk49 [0,0]: 0,40000 
dk2 dk18  dk34 dk50 [0,0]: 40000,” 
dk3 dk!9 = dk35 — dk51 [0,0]: 60000," 
dk4 dk20 | dk36 = =dk52 [0,0]: 80000,” 
dk5 dk21 =dk37 ~— dk53 [0,0]: 100000,” 
dk6 dk22  dk38 dk54 [0,0]: 120000,” 
dk7 dk23. dk39 —s dk55 [0,0]: 140000," 
dk8& dk24 dk40 dk56 [0,0]: 160000,” 
dk9 dk25  dk41  dk57 [0,0]: 180000," 
dk10  dk26 dk42 dk58 [0,0]: 200000,7 
dkil  dk27 = dk43  dk59 [0,0]: 220000," 
dk12.  dk28 3 dk44 = dk60 [0,0]: 240000, 
dk13. dk29. dk45.—s dk61 [0,0]: 260000,7 
dk14. dk30. = dk46—s dk62 [0,0]: 280000,” 
dk15  dk31. = dk47.—s dk63._ [0,0]: 300000, 


where ~ represents the length in sectors from that offset to the end of the disk. If you alter 
any of these entries, you must specily the actual file length or distance to the end of the 
disk in lieu of the ~ symbol. 


The procedure for adding a second-through-fourth disk drive is described below: 


1. 


iw 


Determine the number of sectors you have available on the new disk. You can obtain 
this figure from Table 11-1 in Chapter 11, “fhe Standalone Environment,” or from 
the dformat print-out supplied with the disk itself if you ordered it from Plexus. If 
neither of these means is reliable for your installation for some reason, determine the 
number of sectors with the following equation: 


total sectors = (((totcyl-altcyl)-2)*no.heads)*sectors per track 


Determine how you want to allocate the space for file system(s) on the add-on disk. 
‘Two factors involved are: 


— The size of each file system you will put on the new disk 
— The specific file systems and directories you want to put on this disk 


Examine the sector offsets in Table 8-3 and decide which dk numbers correspond to 
the number and size file system you wish to create or move to this disk. 


For example, if you wanted to create a series of 20 Mb (20000 1K blocks) file sys- 
tems, you would choose sector offsets 40000 sectors apart (512-byte sectors). 

Create the block and raw devices in /dev for each dk offset you chose in the previous 
step: 


mknod /dev/dkX 5 0 X 
mknod /dev/rdkX ¢ 3 X 


where X is the dk number you chose. Repeat this step for every dk number you are 
using on the new disk. 
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8. 


9, 


10. 


Make file systems for each of the logical block devices you created in the previous 
step. Determine the number of blocks per lile system by taking the sector lengths 
determined in step 3 and dividing by 2. 


mkfs /dev/dkX nnnnn m 500 


where X is the device number. nnnnn is the file size in IK blocks, and m is the 
freeblock interleave factor of | for all P/35s through Sys3 version 3.3. 


Ensure that the superblock is updated before performing any more steps by entering: 
syne ; sync 

Create or choose the directories that will be assoctated with these file systems: 
mkdir ./dirname 


where // is the path to the directory and dirname is the name of the directory you are 
creating. For example, to create a second user directory called /usr/user2. enter: 


mkdir /usr/user2 
Mount the logical disks you created to the directory names you just created or chose: 
mount /dev/dkX ./dirname 


where X is the dk number you have allocated from the add-on disk and ./dirname is 
a variable as explained in the previous step. For example. to mount /dev/dk22 to 
/usr/user. enter: 


mount /dev/dk22 /usr/user2 
Check your success by running 
df -t 


on the new file system(s) to ensure that the operating system sees the files as you 
created and sized them. If the system response is unsatisfactory, check every step you 
followed for accuracy and consistency. Especially check that you calculated the disk 
size properly and did not confuse sector counts with block counts. 


If you are satisfied with the results of the previous step, add the new logical devices to 
the mount and umount sections of the /ete/re file so they too will automatically 
mount and unmount when you move the system between single- and multi-user ini- 
tialization states. 
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Chapter Nine 


IMPLEMENTING SCCS 


This chapter is intended to provide a short introduction to SCCS. SCCS has many more 
features, commands, and command options than are described here. For more informa- 
tion, see the Volume IT document on SCCS, and the appropriate manual pages. 


9.1 What SCCS Does 


SCCS was originally developed as a way for individual programmers to track changes to 
code. It saves previous versions and generates bookkeeping information such as number of 
lines added, deleted, and unchanged between versions, when each revision was created, 
and provides the means for the user to add summary comments associated with each ver- 
sion. It can be used in conjunction with make or shell procedures to combine modules. 


SCCS can also track code and documentation changes for large programming and technical 
writing projects, where many people may make changes to the same files. In this environ- 
ment, SCCS ensures that 


— Only authorized persons may write to the files in the SCCS database. When the SCCS 
administrator puts a file into SCCS, s/he includes a list of people authorized to write to 
this file. As part of its bookkeeping SCCS records who created each revision. 


— Only authorized persons may add or delete liles in the SCCS database. SCCS direc- 
tories are owned by the SCCS administrator, so it is difficult for anyone but the SCCS 
administrator to make any really destructive changes to the SCCS database. 
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9.2 How to Use SCCS 


You can use SCCS as an individual or as a member of a team. How you use SCCS com- 
mands, and how much access to them you have, depends on whether or not you are the 
only user. 


This is a list of the most common SCCS commands and what they do. 


admin Puts files into SCCS. 


get Gets you a copy of the SCCS file. With the -e option, not available to all users, 
gets you the file with delta-permission, t.e., you may make official changes 
(deltas) to tt. 


delta Puts a file back into SCCS and creates an officially changed version. Not all 
users have access to this command for all files. 

rmdel Undo the last delta and leave the file status exactly as it was at the most recent 
revision. 

prs Gives history of an SCCS file. Using prs, you can find out practically anything 


about any rev level of an SCCS file. 


These commands are discussed one by one in the following sections with the versions of the 
commands noted that have demonstrated practicality. 


9.2.1 admin 
To put a file into SCCS, you can use the command 
admin -i<filename> -a<userid> ... -y<comment> s.<filename> 


The -i means this is a new SCCS file. Note that you put no spaces between the -i and the 
filename. 


The *-a’ means that the users whose user ids follow are permitted to make changes to this 
file. More specifically, these are the people allowed to use the commands get -e and delta 
on this file. Note no spaces between the *-a’ and the user ids. You must include this field 
if you want to be the only one who can write to the file. If you leave it out altogether, 
SCCS lets anyone write to the file. 


You can use the ‘-y’ field to insert special comments. If you leave it out, SCCS supplies a 
stock first comment. Example A at the end of this chapter demonstrates using the *-y’ field 
to distinguish customized from source versions of UNIX manual pages. (The ones without 
a comment in the *-y’ field are exactly the same as the SYSTEM IIT source versions.) 


The -y option serves the same function for admin that delta comments serve for later revi- 
sions, since in SCCS terms, admin creates the first delta. 


The s. in the last field is especially important. All SCCS filenames begin with s.. 


Admin doesn’t give any response if all goes well; it just returns your shell prompt. It will 
complain if your file does not contain SCCS id keyword, however. This is not fatal — 
your file gets admin’d anyway — but SCCS will continue to complain about the absence of 
id keywords every time you delta the file, so you might as well put them in the file. SCCS 
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will not complain as long as you have added at least one line id keywords. The following 
three lines provide the information essential to most applications. 


\" Revision Level %1% 
\" Last Delta %CU YU% 
\" File Name YM% 


Tf you put these at the beginning of each file, when the file is gotten (with get) read-only, 
the id keywords are interpolated with the appropriate information. This way users can tell 
the revision level of software or documentation produced on your computer. The manual 
page on get (not admin) gives the complete list of id keywords. 


When you admin a file, you create revision 1.1 by default. Subsequent revisions are 1.2, 
1.3, 1.4, etc., and you can also bump the major revision level number with an option to 
get. 


The format of the ‘s.’ file created by admin is described in sccsfile(5). As an SCCS user, 
you may never need to know much about the internal structure of the ‘s.’ file. You should 
realize, however, that the °s.’ file is where all the history is kept--all the bookkeeping infor- 
mation as well as all the previous versions of the file. If it gets destroyed, you lose all the 
SCCS information. This is why ‘s.” files are so well protected: they are automatically made 
mode 444, and in large projects, the directories in which they live are owned by the SCCS 
administrator, not by users. 


Admin can also be used to give a new user permission to make deltas, or remove or 
renumber previous deltas, and many more abilities beyond the scope of this chapter. As 
you might expect, admin is used mostly by the SCCS administrator in large projects. 


Like all SCCS commands, admin can be used in shell procedures, like the one in Example 
A. That one admins all the files in one section of the Volume 1 UNIX Programmer's 
Maaual. 


9.2.2 get 
To read an SCCS file, use the command 
<path> /s.<filename> 


This gets you the most current version of the file read only (mode 444). Sometimes you 
just want to know what’s there; no need to get it with more powerlul permissions. 


To get a specilic version read only, use 
get -r<rev level> <path>/s.<filename> 


You can use this for verification of changes and when executing makeliles to put manuals 
together. (The makelile in Example D executes a series of get -r commands. The variables 
R_<FILENAME> stand for the revision levels defined in the revs file. This ts discussed 
more fully in the "Setting Up for Many Users”’ section of this chapter.) 


To read and write an SCCS file, but NOT with the intention of creating an official delta, 
use 


get -k <path>/s.<filename> 
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This is much more useful than it may seem. For example, if you want to create a new file 
that is almost identical to the SCCS file, get -k gives you the [ile with permission mode 644, 
but does not create a lock file (see below). 


To read and write with the intention of creating an olticial revision, use 
get -e <path>/s.<filename> 


Not all users are allowed to use get -e on every file: only the ones named in the original 
admin (or subsequently added). 


The file you receive with any get has the ’s.” pretix removed; it is the result of SCCS pro- 
cessing of the ‘s.’ file. All gets leave the file *s.<lilename>’ in the SCCS directory, but get 
with -e has another effect: it creates an additional file called *p.<filename>’. This file is a 
lock file; once you get the file with *-e’, ‘p.filename’ is created and no one else can get the 
file with ‘-e’. (They can, however. get the file read only, or with *-k’.) The existence of 
‘p.filename’ is useful to remind you which files you, or other users, still have out under get 
with *-e’ when it comes time to put all the documents together. It is also the best way to 
find out, if many people can get the file with *-e’, who actually has gotten it. To find out, 
just read it. 


The ‘p.lile’ goes away when vou delta back the [ile you obtained with get -e. 


In team projects, users cannot execute gets from within the SCCS directory, since this direc- 
tory is owned by the SCCS administrator. If you create SCCS files for your own personal 
use, your working directory makes no difference. 


Get has other {lavors, but these are the ones used most of the time in most applications. 


9.2.3 delta 


Tf you use SCCS for your files alone, you automatically have permission to make deltas to 
them. For large projects, not everyone can delta — you must have delta-permission, which 
is bestowed by the SCCS administrator. The standard delta command is 


delta <path>/s.<filename> 
SCCS responds 
Comments? 


and you type whatever you like. On large projects there ts usually a standard format for 
delta comments, which includes programmer’s name, the revision level of the software for 
which the delta was made, and what was changed in the file. These comments are saved 
along with the file, and can be displayed with prs or prt. SCCS then reports the number of 
lines added, deleted, and unchanged between this revision and the last and gives the new 
revision number. The file you delta is also removed automatically from your directory. 


Other options to delta allow you to keep a copy of the lile you delta, suppress delta’s 
responses, give the Modification Request (such as an engineering change order) number for 
which this delta was made, give your comment on the command line, and automatically 
diff, on standard output, the tile you delta with the previous version. 
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9.2.4 rmdel 


This command removes revisions of SCCS files. It has important restrictions on use, how- 
ever. First, you can only remove a delta that you created; and second, you can only 
remove the last (i.e., most recent) one. Standard syntax is 


rmdel -r<rey level> <path>/s.<filename> 


When lots of delta-makers are involved, the use of rmdel is sometimes restricted to the 
SCCS administrator. 


9.2.5 prs 


Read the Volume [ account of prs; it contains examples of how to construct prs requests. 
The sample shell prt in Example B does a prs; sample output is shown in Example C. 


Prs has options to list information by time parameters, e.g., before or alter a specilied revi- 
sion. You can use prs with these options to verify files like Example E, which illustrates 
keeping the current revision levels of all the files for a specific manual. This way, you can 
double-check that no deltas were made that were not recorded in the revs file. You can 
also use it as a source for writing summaries of the changes to the files since the last revi- 
sion of a manual. Prs takes directory names as arguments, giving you history information 
for all files within a directory, so you can get much information with one command. 


9.3 Updating an SCCS File 


This is a typical command sequence for updating an SCCS Tile. It is not very complicated; 
most of the time, this is what using SCCS amounts to. 


1. Be sure you are in a directory you can write to. If the file you want to change is in a 
directory owned by the SCCS administrator, you cannot write to it while you are in 
that directory. 


2. Get the file with get -e by entering: 
get -e s. filename 


Remember that the name of the copy that goes to your working directory does not 
have the ‘s.’” pretix. 


3. Edit the file. 
4. When you are [inished, put the [ile back into SCCS using delta. 
delta <path>/s, <filename> 
SCCS responds 
Comments? 
and you type whatever you like. 


5. If you are using makefiles and revs tiles as discussed in the next section, update the 
revs file. 
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9.4 SCCS and Makefiles 


SCCS can be used in conjunction with make to create large multi-file manuals. ‘This same 
procedure can also be used, alter each module has had its changes made, for combining 
program modules. 


It’s handy to have one file containing the makefile, and a separate one containing the list of 
revision levels you want for a particular make. You may want to keep these files under 
SCCS control, too, because thev are tedious to recreate. If you have used make, the pro- 
cedure is pretty self-explanatory. You can substitute the tools and build procedures 
appropriate for your task (e.g., compiles). Samples of the makeliles and revs files are 
included in Example D and Example E. 


To put together a manual composed of many separate files, all under SCCS control, and 
assuming vou want the latest revision of each file, do the following: 


1. Make sure no relevant files are stull being delta’d. Perform Is on the appropriate 
directories for *p.” files. Tf you find any still being changed, read the ‘p.’ file to see 
who is changing it; find out whether the change is important enough to delay the 
build. 


Be sure the revs file reflects the current highest rev level of all relevant files. Verify 
this with prs or prt tf you’re not sure. 


i) 


3. It’s handy to do the make in a directory reserved just tor doing makes. Create one if 
you don’t have one. 


4. Move or copy the makefile and revs file to the special directory. he directory 
should now contain these two files only. 


La) 


From within the make directory, issue the make command 
make -f makelile_name 


6. The makefiles for the manual sections first do a series of get -r commands. They get 
the value of ‘r’ from the revs file that is included at the beginning of the maketile. 
This procedure assumes the revs file is current; i.e., all the levels listed are the most 
recent ones. (To create a manual that mixes current and down-level versions of 
specific pages, just make sure the revs file you use lists the levels you want, rather 
than all the current ones.) Then you see the typical get responses as each file is got- 
ten: the revision level and the number ol lines in the tile are listed. he files are then 
concatenated and printed. 


This makefile also allows you to put its result, the manual section, into a directory 
($1) other than the one in which you did the make. If you want to do this, deline 
$T as something other than °.’. 


7. Clean up the directory when you’re done. Use rm -f because the files are all mode 
444, 


9.5 Preparing to Make a New Online Manual 


Because all the manual files are in SCCS format, you can’t just copy the °s.” files into 
/usr/man; they contain many lines that are unrecognizable to the program that formats the 
man pages for the screen. Therefore, you must get (no options) the SCCS files belore 
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putting them into /usr/man. This does what you want: 


1. Tt fills in the SCCS id keywords, so anyone reading the raw /usr/man [ile can see the 
rev level and date of fast delta. 


2. It makes the lile mode 444, so the master customer copy can’t be written to. 


3. It strips the ‘s.” prefix, so the filenames look exactly like the old ones. 


9.6 Setting Up for Many Users 


The SCCS document, “Function and Use of an SCCS Interface Program” in the Unix 
Programmer's Manual, vol2B, describes one way to set up SCCS systems for many users. 


This document points out that for a given project whose documents will be controlled and 
held in an SCCS directory you should assign an SCCS administrator who will own all the 
files and the SCCS interface program. It is best that this administrator have a login name 
unique to the project; that is, the ownership of the files and interface program should not 
be root or the login name of any of the project participants. The reason for this is to keep 
SCCS administrative and update work separate, and to keep a project member’s usual login 
(or root) from inadvertently removing SCCS files. This can be accomplished in one of at 
least two ways: 


t. Assign SCCS administration to a person not involved in the project. This person’s 
only involvement in the project would be to maintain the files and alter project 
members’ privileges such as get and delta according to the project’s needs. 


i) 


Assign SCCS administration to a member of the project, but create a fictitious alter- 
nate login name for that person. Give ownership of the SCCS files to the fictitious 
name. This keeps the project member’s role as SCCS administrator (maintenance of 
the SCCS'd files) separate from the role as an active project member (updating of the 
files). 


Then, following the guidelines in the "Function and Use of an SCCS Interface Program” in 
the Unix Programmer's Manual, vol2B, the SCCS administrator could write or copy a sim- 
ple C program such as inter.c shown in Example F, which executes the command on the 
command line. 


NOTE 


Be sure to follow either the syntax in Example F at the end 
of this chapter or the description of how to write an interface 
program in the *Function and Use of an SCCS Interface 
Program” in the Unix Programmer's Manual, vol2B, rather 
than the sample interface program listed there. That sample 
interface program contains errors. 


In Example F, the set-userid bit has been set so the object file, inter, looks like it’s always 
being executed by the SCCS administrator, who in this case is sandyl. The sample pro- 
gram then links inter with the sensitive commands, get, del“, and fhdel. Users must have 
/user/sandy1 in their command paths before /usr/bin, where get, Aétta, and rmd&i usually 
reside. SCCS takes care of the rest. 
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With the program illustrated in Example F. any user can do get with no options, or with *- 
r, or *-k’; SCCS makes sure only the users designated by the SCCS administrator have 
access to ‘get -e’, delta. and rmdel. When a user tries to execute a get -e or delta or 
rmdel, SCCS reads the permission list associated with the file. Then if the user is author- 
ized, SCCS executes the command in /user/sandy1, (in the user’s path ahead of the one in 
/usr/bin), linked with inter, which makes the command look like it came {rom sandy]. 


If you were to link inter with admin as well, all project members would have admin 
privileges. Whenever someone admins a new l[ile. however, it involves putting new entries 
into the appropriate makelile and revslile. This extended privilege could defeat the pur- 
pose of having an SCCS administrator. 


You may elect to achieve the same effects in other, perhaps simpler. ways such as: 
a. Copying and renaming get and the other sensitive SCCS commands, 
b. Fixing the set-userid bit, 


Putting the renamed commands in a special directory, 


© 


d. Instructing users to put this directory in their path. 
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EXAMPLE A 


This is the first part of a shell procedure that admins an entire directory at once. 


admin -ta.out.5 -asandy -agreg ~amike ~-acraig -y"Changed pdp-11 and var 
refs to z8000 and 68000; changed base for calcs from octal to hex; 
68000 stuff all commented out" s.a.out.5; rm a.out.5 

admin ~-iacct.5 ~asandy ~-agreg ~amike -acraig -y s.acct.5; rm acct.5 
admin -iar.5 -asandy -agreg -amike -acraig -y"Changed pdp-11 and vax 
to z8000 and 68000" s.ar.5; rm ar.5 

admin -ichecklist.5 -agandy -agreg -amike -acraig -y s.checklist.5; 

rm checklist.5 

admin -icore.5 -agandy -agreg -amike -acraig -y"Removed ref to 

sdb" s.core.5; rm core.5 

admin -~icpio.5 -asandy -agreg -amike -acraig -y s.cpio.5; rm cpio.5 
admin -~idir.5 -asandy -agreg -amike -acraig -y s.dir.5; rm dir.5 

admin -idump.5 -asandy -agreg -amike ~-acraig -y"Changed block 

size from 512 to 1024 bytes" s.dump.5; rm dump.5 

admin -ierrfile.& ~asandy -agreg ~amike -acraig -y*"*Put 

in correct #defines" s.orrfile.5; rm errfile.5 

admin -ifilesystem.5 -asandy -agreg -amike ~acraig -y s.filesystem.5; 
rm filesystem.5 

admin ~itfs.5 ~asandy -agreg -amike -acraig -y"Changed block 

size from 512 to 1024 bytes; changed how to calculate 

where inodes are" s.fs.5; rm f8s.5 

admin -itfspec.5 -asandy -agreg -amike -acraig -y s.fspec.5; rm fspec.5 
admin ~igps.5 ~asandy -agreg -~amike -acraig -y s.gps.5; rm gps.5 

admin -igroup.5 ~asandy -agreg -amike ~acraig -y s.group.5; rm group.5 
admin -iholidays.5 ~asandy -agreg ~amike ~acraig -y"Plexrus 

addition" s.holidays.5; rm holidays.5 

admin -iinittab.5 -asandy -agreg -amike -acraig ~y"Usage 

notes for init" s.inittab.5; rm tnittab.5 

admin -iinode.5S -asandy ~agreg ~amike -acraig -y s.inode.5; rm itnode.5 
admin -1lintro.5 -asandy -agreg ~amike ~acraig -y"Mentioned Plexus 
additions and deletions" s.intro.5; rm intro.5 
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EXAMPLE B 


# This ie the shell procedure that corresponds to the 
# command prt. Prt prints history information about SCCS 
# files in the format specified here. 


prs -d"OF:Rev :I: Delta made on :Dm:/:Dd:/:Dy: :T: by :P: 
:DL:O0C:" -e -1 $1 
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EXAMPLE C 


This is output of prt. 


s.fsck.im Rev 1.6 Delta made on 
11/10/82 15:27:02 by sandy 00016/00005/00266 added note that 
Plexus provides stand version, and that this version supports at 
most five args. 


s.fsck.im Rev 1.5 Delta made on 
10/27/82 13:12:08 by sandy 00001/00001/00270 Changed id keywords 


s.fsck.im Rev 1.4 Delta made on 
10/25/82 12:11:12 by sandy 00009/00004/00262 sandy~-delete ist 2 
options for -s8X; add bug that too quick rebooting after mesg 
invalidates corrections. 


s.fsck.im Rev 1.3 Delta made on 
10/19/82 16:49:32 by sandy 00003/00000/00263 sandy for sys3 1.1: 
added bug notice about fifos. 


s.fsck.im Rev 1.2 Delta made on 
10/18/82 17:11:10 by sandy 00003/00000/00260 ID keywords 


s.fisck.1im Rev 1.1 Delta made on 


10/18/82 14:21:16 by sandy 00260/00000/00000 Added ref to 
appropriate doc 
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EXAMPLE D 


This is a sample maketile for Volume 1, Section 5. 


Revision Level 1.1 
Last Delta 16:51:13 
File Name makeman5 


#include revsmanS 


# 
# 
# 


Ss 
Cc 
T 


# 


Ss 
Cc 
T 


ScCS directory 
Source directory 
Target directory 


u 


= /user/sandy/man5 


Tools required 


CAT = cat 


NROFF 


nroff -man 


TROFF = troff -man 


# 


MAN_PAGES = 
$c/intro.5s 
$C/fa.out.5 
$C/facct.5 
$c/ar.5 
$C/checklist.5 
$C/core.5 
$C/cpio.5 
$C/dir.5 
$C/dump.5 
$C/errfile.5 
$C/fe.5 
$C/fepec.5 
$C/gps.5 
$C/group.5 
$C/holidays.5 
$C/inittab.5 
$C/inode.5 
$c/mnttab.5 
$C/pasewd.5 
$C/plot.5s 
$C/pnch.5 
$C/profile.5 
$C/sccsefile.5 
$C/termcap.5 
$C/tp.5 


The gource file names. 


an an dan a dan an an an a a an a a dan a a a da a a da a a da dade 


$C/utmp.5 
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# Build all 

all : $T/man5 

$T/man5S : $(MAN_PAGES); \ 

$(CAT) $(MAN_PAGES) | $(NROFF) > man5S 


# How to make each page. 


$Cc/intro.5 :$S/s.intro.5 ;ed $C; get $(R_INTRO_S) $S/sa.intro.§ 
$C/fa.out.5 :$S/s.a.out.5 ;ced $C; get $(R_A_OUT_5) $S/s.a.out.5 
$C/facct.5 :$S/se.acct.5 ;ed $C; get $(R_ACCT_S5) $S/s.acct.5 
$C/ar.5 :$S/s.ar.5 ;cd $C; get $(R_AR_5) $S/s.ar.5 
$C/checklist.5 :$S/e.checklist.5 ;cd $C; get $(R_CHECKLIST_S) $S/s.checklist.5 
$C/core.5 :$S/e.core.5 ;ed $C; get $(R_CORE_S5) $S/s.core.5 
$c/cpio.5 :$S/s.cpio.5 ;cd $C; get $(R_CPIO_5) $S/s.cpio.5 
$C/dir.5 :$S/s.dir.5 ied $C; get $(R_DIR_S5) $S/s.dir.5 
$c/dump.5 :$S/e.dump.5 ;ed $C; get $(R_DUMP_5) $S/s.dump.5 
$C/ferrfile.5 :$S/e.errfile.5 sed $C; get $(R_ERRFILE_5) $S/s.errfile.5 
$C/fs.5 :$S/ea.fa.5 jed $C; get $(R_FS_S5) $S/s.fs.5 
$C/fepec.5 :$S/s.fespec.5 ;ed $C; get $(R_FSPEC_5) $S/se.fspec.5 
$C/gps.5 :$S/e.gps.5 sed $C; get $(R_GPS_5) $S/se.gps.5 
$C/group.5 :$S/e.group.5 sed $C; get $(R_GROUP_5) $S/s.group.5 
$C/holidays.5 :$S/e.holidays.5 ;ced $C; get $(R_HOLIDAYS_S5) $S/s.holidays.5 
$C/inittab.5 :$S/se.inittab.5 ;ed $C; get $C(R_INITTAB_S5S) $S/s.inittab.5 
$C/inode.5 °$S/s.inode.5 ;ed $C; get $(R_INODE_5) $S/s.inode.5 
$C/mnttab.5 :$S/a.mnttab.5 ;cd $C; get $(R_MNTTAB_5) $S/as.mnttab.5 
$C/passwd.5 :$S/s.pasewd.5 jyed $C; get $(R_PASSWD_5) $S/s.passwd.5 
$c/plot.5 :$S/s.plot.5 ped $C; get $(R_PLOT_5) $S/s.plot.5 
$C/pnch.5 :$S/e.pnch.5 iced $C; get $(R_PNCH_5) $S/s.pnch.5 
$C/profile.5 :$S/s.profile.5 sed $C; get $(R_PROFILE_5) $S/s.profile.5 
$c/sccsfile.5 :$S/s.sccsfile.5 ;ed $C; get $(R_SCCSFILE_5) $S/s.sccefile.5 
$C/termcap.5 :$S/se.termcap.5 ;ed $C; get $(R_TERMCAP_5) $S/s.termcap.5 
$C/tp.5 :$S/e.tp.5 ;ed $C; get $(R_TP_5) $S/sa.tp.5 
$C/utmp.5 :$S/s.utmp.5 ;ed $C; get $(R_UTMP_S5) $S/sa.utmp.5 
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EXAMPLE E 
This is a sample revs file. 
# Revision Level 1.1 
# Last Delta 16:52:01 11/3/82 
# File Name revsmansd 
# Rev levels of man5S source. 
R_INTRO_5 = -r1.2 # s.intro.5 
R_A_OUT_5 = -r1.2 # s.a.out.5 
R_ACCT_5 = -r1.2 # s.acct.5 
R_AR_5 = -r1.2 # s.ar.5 
R_CHECKLIST_5 = -r1.2 # s.checklist.5 
R_CORE_5 = -r1.2 # e.core.5 
R_CPIO_5 = -r1i.2 # s.cpio.5 
R_DIR_5 = -r1.2 # s.dir.5 
R_DUMP_5 = -r1.2 # s.dump.5 
R_ERRFILE_5 = -r1.2 # s.errfile.5 
R_FS_5 = -r1.2 # s.fs.5 
R_UFSPEC_5 = -ri.2 # s.fspec.5 
R_GPS_5 = -r1.2 # s.gps.5 
R_GROUP_5 = -r1i.2 # s.group.5 
R_HOLIDAYS_5 = -r1.2 # s.holidays.5 
R_INITTAB_5 = -r1.2 # s.inittab.5 
R_INODE_5 = -r1.2 # ge.inode.5 
R_MNTTAB_5 = -r1.2 # e.mnttab.5 
R_PASSWD_5 = -ri.2 # s.passewd.5 
R_PLOT_5 = -ri.2 # s.plot.5 
R_PNCH_S5 = -r1.2 # s.pnch.5 
R_PROFILE_5 = -r1.2 # s.profile.5 
R_SCCSFILE_5 = -r1i.2 # s.seccsfile.5 
R_TERMCAP_5 = -r1.3 # s.termcap.5S 
R_TP_5 = -r1.2 # s.tp.5 
R_UTMP_5 = -r1i.2 # s.utmp.5 
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EXAMPLE F 
/* 
This is the SCCS interface program, which makes possible 
the use of SCCS commands on files in the SCCS administrator's 
directories by other users. 
«/ 


#include <stdio.h> 
#define LENGTH 100 
main(argc, argv) 


int argc; 
char *argv[]; 


{ 
register int 1; 
char cmdstr[LENGTH] ; 
/* 
Invoke SCCS command, passing args. 
*/ 
sprintf(cmdstr, "/usr/bin/%s", argv[O]); 
execv(cmdstr, argv); 
} 
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Chapter Ten 


IMPLEMENTING UUCP 


Chances are if you can phone someone at another UNIX site, your computers can also talk 
to each other using the UNIX utility uuep. uucp allows UNIX systems to communicate 
with each other over phone lines or hardwired communication lines. Using uucp, you can 
transfer files from one UNIX machine to another, send electronic mail, issue UNIX com- 
mands from your terminal to be executed on another UNIX machine, send or receive 
software or patches, and perform many other general communications tasks. There is even 
an informal UUCP Network that links several thousand UNIX sites. 


Note that uucp works as a batch operation. This means that jobs can accumulate and then 
all get done at one time. Uucp ts primarily for queueing and executing remote jobs, i.e., 
jobs on UNIX systems different trom your home system. A job might be a file transfer, 
copy, mail, list, etc.; most UNIX commands are capable of being executed remotely, 
though in practice, sites seldom allow remote users to do much. The jobs awaiting execu- 
tion are kept in a spool directory; on Plexus systems, this is /usr/spool/uucp. Then, when 
your computers call each other, they search the spool directory to see if there is any work 
to do. If there is work, they begin to perform the jobs. 


The setup effort involved for uucp ts minimal: all that’s required is a bit of customization of 
a couple of files, a modem or hardwire connection, and someone to talk to. This chapter 
provides the general procedure to get uucp working for you. For more information, read 
the standard UNIX documentation on uucp. Your uucp neighbors may also be helptul. 


Note that the procedures listed here are a subset of those in the document UUCP Imple- 
mentation in the Plexus Sys? UNIX Programmer's Manual -- vol 2B. Some of the setup 
procedures described in that document involve modifying UNIX source files such as uucp.h 
and makefile, and recompiling source. Plexus’ license with Bell Laboratories does not per- 
mit us to distribute UNIX sources to customers, so Plexus has done this portion of the uucp 
setup for you in advance. In particular, you can assume that all the uucp programs are in 
the right directories with the right permissions attached to them, have reasonable defaults, 
and are ready to run. You just have to supply information particular to your site, e.g., 
who you want to talk to, and what port(s) you will use. 


You must decide a few issues and obtain various pieces of information before you can 
begin the setup. 
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1. Will your link be over phone lines or direct? 
2. Do you want to call only, be called only, or both? 
Who will you contact? 


What sorts of tasks do you want to be able to do on the remote system? 


Ae oY 


What sorts of tasks do you want remote users to be able to do on your system? 


The next few introductory sections deal with these questions. 


10.1 To Call or Not to Call? 


With uucp. as with most computer communications protocols, a distinction is made 
between the caller and the callee. If you call the other site, your site is ‘master’; if they 
call you, you are “‘slave’’. This distinction is important because it determines the type and, 
to a lesser extent, the amount of setup work you need to do. So you should first determine 
whether you can connect with another site on an ‘‘on-demand”’ basis (i.e, both call and be 
called), or whether you will always call or be called. How do-.you decide? 


This sort of decision is often made on the basis of what hardware is available to you. The 
general rules are: if you can be called, you must make a login port and modem available to 
uucp; if you can call, a non-login port and modem (preferably autodial) must be available. 
Tf you can both call and be called, you need two ports and two modems. The same rules 
apply to any sites you might want to link to. 


So if you don’t have an autodial modem but want to establish contact regularly and 
automatically (e.g., to transmit electronic mail), you'd probably want always to be called by 
your uucp neighbors. You'd take the slave role. If you have an autodial modem but only 
one available port, you might elect to be master. 


Many users find the most convenient way to set up uucp connections is on an “‘on- 
demand”’ basis; that is, each partner is capable of both calling and being called, and calls 
are made only when one or the other site has work. In this case, both sites must equip 
themselves to play either role. 


The minimum hardware requirements are just a plain modem and dialup port on both 
sides. Note that even if you and your potential neighbor both have only this minimum, 
you can still converse over uucp. You just have to dial each other manually. In this case, 
your connection would be “‘direct’’, as far as uucp is concerned, since you do not use an 
Automatic Call Unit (ACU). 


Many installations with several CPUs on site link them directly via cables rather than over 
phone lines. Tf you are going to set up direct links, you still need a login port for each 
remote machine, if they call you: and a dialout non-login port, if you call them; and two 
ports per remote machine if you both call and are called. 


Tf you run the Plexus Network Operating System (NOS) to link several local CPUs, you 
may link all the local nodes with virtual ports. Connecting to remote sites -- those not on 
the NOS net -- involves the same hardware requirements listed above. 


So first figure out what kind of hardware you have available for uucp, whether you want 
calls to be made automatically, and how many free ports you have. Decide what your 
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options are; your potential neighbor’s requirements may also influence this decision, since 
one or the other of you may have more flexibility. 


10.2. Who Will Be Your Neighbor? 


Who will you contact? You can in theory contact any UNIX SYSTEM III or Version 7 
site that also has the uucp package. But some sites are going to be especially important to 
you; these are your uucp “‘neighbors’’. These are sites you are called by or call. They in 
turn have other neighbors, and through the network of neighbors, you can actually com- 
municate with many more systems than you call, because messages are piggy-backed as they 
are carried from one site to the next. 


Once you’ve got a site in mind, get in touch with them to inquire if they would like to be 
your uucp “neighbor’’. People usually agree readily if you just want to exchange mail and 
an occasional file; it can be more difficult to find a neighbor if you also wish to exchange 
Usenet news.* If they agree, then exchange system names, phone numbers, login ids, and 
passwords as necessary (see below). The second half of this document (section 2.0) 
discusses in detail how to make the necessary modilications to system files, once you have 
this information in hand. 


You should still be able to communicate via uucp with sites that are unwilling to be your 
immediate neighbors; you can probably reach them through a shared neighbor, for exam- 


ple. 


Your system name (the “nodename’’) is how your system will be known to the uucp world. 
Tt can be found by issuing the uname command with the **-n” option. (Uname alone -- 
without **-n” -- may not work, if your system name and nodename differ.) If you don’t 
have a nodename, you can assign one by running the program deonfig. See the appropri- 
ate Plexus User’s Manual lor your system for complete information on running dconfig. 


The phone number you give the other site is the phone number of your modem; the login 
id and password are what they will use on your system. They in turn may give you their 
system nodename, phone number, and a login id and password for you to use on their sys- 
tem. 


Less exchange of information is necessary if one or the other party is always going to be 
master or slave. If you are always going to be master, you need all four pieces -- system 
name, phone number, login id and password for your neighbor’s system -- for every site 
you call; but your neighbors need only your system nodename. They already know their 
own phone number, and they know your login id and password because they gave them to 
you. They don’t need your phone number or a login id or password for your system since 
they never login to your system. So masters need the following: 


* Usenet news is not a Plexus product. and Plexus does not support it. 
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Master Needs Slave Needs 
Slave system nodename Master system nodename 


Slave phone number 
A login id on slave system 
A password on slave system 


Conversely, if you are always going to be slave, your neighbor sites each need your 
nodename, phone number, a login id and password on your system, but you need only the 
nodenames of your neighbor systems. You don’t need login ids or passwords for their sys- 
tems because you never login to other systems. 


If both sites are going to call and be called (‘‘on-demand’’), then you both need all the 
information about each other. The following table illustrates the information that needs to 
be exchanged for two-way “‘on-demand”’ calling. 


You Provide They Provide 

Your system nodename Their system nodename 
Your phone number Their phone number 

A login id on your system A login id on their system 


A password on your system _A password on their system 


Before contacting potential neighbors, make a list of the information you think you will 
need and the information you will have to provide. 


10.3. What Can Be Done? 


During the uucp transaction, the master site first does everything it needs to do on the 
remote system, and then the asks the slave site if it has work. If the slave site has work, 
then it begins to execute its jobs on the master’s system. Both master and slave may set 
limits on what can be done by the other; lew uucp users allow their neighbors to have 
unlimited access to their machines. In fact, the set of commands allowed to neighbors is 
usually quite restricted; furthermore, all the file protection mechanisms of your system 
apply within uucp transactions. You can specily what directories will be accessible to 
remote and also local users of your system; this is what the file /usr/lib/uucp/USERFILE is 
for. Changing this file is discussed at length in section 2.2.6 of this document. Olten sys- 
tems make the directory /usr/spool/uucppublic the only login directory for remote users. 


So now let’s suppose you know what role you will assume in the exchange (master or slave 
or both), and you have found a neighbor. and have the necessary calling and login infor- 
mation in hand. You also have an idea how much you want your neighbor to be able to 
do on your system. What do you do now? 
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10.4 Procedures 


This section tells what you need to do to your system to set up a uucp link with a neighbor 
site. All these steps must be done by root. 


10.4.1 Setup for Autodialing 


You must do three things to set up lor autodialing: 


1. Verify that you can use the ACU /usr/plx/dial (Racal Vadic 3451 modems only). 
Otherwise, prepare a different ACU. 


ihe) 


Disable logins on the logical uuep port. 
3. Tf you are autodialing over phone lines, make sure the logical device file /dev/ttyX is 
owned by uucp. 


If you are not going to use autodialing, skip this section and proceed directly to 2.2. 


10.4.1.1 Prepare the ACU 


Plexus provides the autodialing program /usr/plx/dial, which works for Racal Vadic 3451 
modems. ‘This program is an Automatic Call Unit (ACU). 


Tf you have a different kind of modem, you must create a file that will serve as ACU in 
place of /usr/plx/dial. This file should be named instead of /usr/plx/dial in all places that 
specily the ACU. e.g. the file /usr/lib/uucp/L-devices (see below). The uucp system sends 
the following four arguments to the dialing program. 


Argument 0 Program in the L-devices file (your program name). 
Argument 1 Modem TTY line. 

Argument 2. Baud rate of line. 

Argument 3. Phone number. 


Your program should do the right things with these arguments, and return 0 if successful, 
non-zero if unsuccessful. Tt should have permissions of 775. 


We'll assume for the sake of simplicity in the rest of this explanation that your ACU is 
/usr/plx/dial; but remember that if yours is different, you must use yours instead. 


10.4.1.2 Disable Logins on the Port 


To use autodial, the port to which the autodial modem is connected must not be a login 
port. The file /ete/inittab controls whether or not ports are login ports, so you must change 
this file. Find the line in /etc/inittab that refers to the port you have decided to use for 
uucp; suppose it is port 6. It should look like this: 


2:06:c:/etc/getty tty6 b 
Change it so it looks like this: 
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2:06:0:/etc/getty tty6 3 


The **o” disables logins on this port. 


10.4.1.3 Change Owner of Device 


Finally, if you will be dialing out over phone lines (as opposed to direct lines). verily that 
uucp owns the logical device file /dev/ttyX you use for dialing. Uuep needs to own the file 
so it can restrict access to it when uucp is in use. Suppose the device is tty6; if it is not 
owned by uucp, issue the command 


chown uucp /dev/tty6 


10.4.2 UUCP Implementation 
To implement uucp. you must do the following steps: 


1. Verify that your ICP is jumpered correctly for use with a modem. Prepare cable if 
necessary. 


2. Verily the system nodename. 

3. Verily that the /etc/passwd entry tor uucp has /usr/lib/uucp/uucico as its shell. 
4. If your system will make calls, modify /usr/lib/uucp/L.sys. 

5. Modify /usr/lib/uucp/L-devices. 

6. Modily /usr/lib/uucp/USERFILE. 
7 


If your system will call other systems automatically, write the shell procedure to do 
the calling, and modify /usr/ib/crontab to execute the shell procedure automatically. 


As we shall see, ordinary users can modily some uucp files, e.g., they can remove the 
/usr/spool/uucp/STST* files. But all the setup of uucp files described here must be done by 
root. 


10.4.2.1 Hardware Preparation 


The Plexus ICP pinouts are a “null modem”. That is, like most systems, the ICP sends data 
out as if it were a modem already; that is, it does what modems do. (For example, it rev- 
erses transmit and receive.) Since UUCP non-direct connections require a modem, and 
since the modem will continue to perform the same functions already performed in the ICP, 
certain signals from the ICP must be reversed. The cable from the ICP (TTY port) to the 
modem must perform this reversal. The tollowing cabling instructions make the modem 
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work properly for modems that will autodial: 


Plexus Pin Number to Modem Pin Number 


2 3 
3 2 
4 5 
5 4 
6 20 
7 7 
8 8 
20 6 


Do not connect clock pins; they are for synchronous use only. 


If you wish your modem to be autoanswer only, you may connect only pins 2, 3, and 7 as 
shown above. This way, the port may be a regular login port when it is not in use by the 
remote site. 


Modems that will autodial also require the ICP to be specially jumpered. See the ICP Board 
Option Selectors figure in the of your Plexus Engineering Manual for the locations of the 
relevant jumper blocks for the various ports on the [CP. Note that ports 5 through 7 come 
to the left of port 4, which is to the left of ports 0 through 3. Normally you will jumper 
pin pair 3 (for Clear To Send) and pin pair 4 (for Carrier Detect). See the Plexus 
Engineering Manual chapter, ‘““Configuring the [CP”’ for alternate configurations. Do not 
jumper the ICP for an external clock. 


Usually you will not have to worry about the hardware or cabling on the system being 
talked to by your Plexus computer; that is your neighbor’s problem. Your neighbor may or 
may not have a Plexus system. But sometimes a site will have several computers of dif- 
ferent types running UNIX. If you happen to be responsible for another system in addition 
to the Plexus, and you must connect the two machines by modems (not direct, wire-to-wire 
connections), then you must first determine whether the other computer also behaves like a 
null modem, and make cable accordingly. If it does behave like a null modem, you must 
swap the signals not only when they come out of the Plexus, but again when they enter the 
other computer. 


Direct, wire-to-wire connections require cable just like terminals, i.e., pins 2, 3, and 7 must 
be connected. 


10.4.2.2 Verify Nodename 
Tssue the command 
uname -n 


to get the nodename of your system. Your neighbors, as well as other users of uucp, know 
your system by this name, and include it in the uuep pathnames of any commands to your 
system. For example, if your network nodename were plx, a uucp neighbor sending mail 
to userid chris on this node would use the command 


mail plx!chris 


A more remote uucp user (non-neighbor) could reach chris on plx through a more 
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complicated expression, possibly including several nodenames separated by exclamation 
points (!). 
mail node3!node2!nodet!plx!chris 


Csh users must remember to escape the !, preceding it with a backslash (\) since it has spe- 
cial meaning in the C-shell. 


If you don’t have a nodename, run the program dconfig to give yoursell one. See the 
chapter, ‘The Standalone Environment’, on how to run dconfig. 


10.4.2.3 Modify /etc/passwd 


The file /etc/passwd should include a login [or uucp. Il the login shell (last field) for uucp 
is not /usr/lib/uucp/uucico, change it so it is. 


10.4.2.4 Modify L.sys 


Tf you will call other sites, you must modily the file /usr/lib/uucp/L.sys. If you do not plan 
to call other sites, you can still modify this file if you have the relevant information; but it 
won't have any effect either, since L.sys is activated only when you call out. 


The purpose of L.sys is to list the most secret information about sites that you call, such as 
your userid and password on each remote system. Thus L.sys should have access mode 400 
(readable only by root). 


The format of lines in L.sys is as follows: 
remote_nodename time device class phone_number login_into 
where 


remote_nodename the nodename ol the system you are calling. 


time times acceptable for calling. “Any” here means any time is all right; 
this is often used. Or you can specify days and times. Days are 
abbreviated 


Su Mo Tu We Th Fr Sa 


or “Wk” for any weekday. ‘Time should be given as a range of times 
(e.g., 0800-1230). Il no time is specified, any time is assumed to be 
acceptable. 


device either “ACU” if you are using one; or a hardwired device name (e.g., 
tty5), if the connection is direct. If your system is running Plexus 
Network Operating System (NOS) and this connection is on the NOS 
network, this can be a virtual device. 


class the line speed, usually 300 or 1200 baud for phone connections. 
Higher for direct connections. 


phone_number the phone number of the modem at the site you are calling. This can 
consist of just digits (e.g., 415-555-1212) or an optional alphabetic 
part derived [rom the file /usr/lib/uucp/L-dialcodes. For hardwired 
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devices, this field contains the same string as used in the ‘‘device”’ 
field. 

login_info a series of expect-send fields, where ‘‘expect’’ is what you expect to 
read when you connect with the remote site (e.g., login); and send is 
what you will send when the expect string is received (e.g, your 
userid). Passwords are also normally expected. 


A sample L.sys line for a site using an ACU might be the following 
pip Any ACU 1200 415-555-1212 login:-EOT-login: Ppip ssword: giants82 _ 


This says that you contact the site whose nodename is pip. Their phone number is 415- 
555-1212 and they have given you the userid Ppip and the password giants82. 


A sample L.sys line for a direct connection might look like this 
pip Any tty5 9600 tty5 login:-EOT-login: Ppip ssword:giants82 


This says that you have a direct link with the site pip over tty5, at a line speed of 9600 
baud. 


The L.sys line for a NOS connection using a virtual terminal looks like the line for a direct 
connection. 


pip Any vtty.pip 9600 vtty.pip login:-EOT-login: Ppip ssword:giants82 


This says you have a link with the system pip over the virtual terminal vtty.pip at a line 
speed of 9600 baud. 


{0.4.2.5 Modify L-devices 


The file /usr/lib/uucp/L-devices must be modified to contain information about your ACU 
or direct line. Add a line whose format is 


type line call_unit speed 


where 

type ACU or DIR (direct). 

line the logical device you are using, e.g. tty6. 
call_unit the ACU. Direct lines have “0” in this field. 
speed the line speed. 


For example, if you use /usr/plx/dial and tty6, add the lollowing line to L-devices: 
ACU tty6 /usr/plx/dial 1200 

If you use a direct connection over tty6, the line would look like this: 
DIR tty6 0 9600 


Tf you use a virtual terminal connection with the virtual terminal vtty.pip, the line would 
look like this: 


DIR vtty.pip 0 9600 
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10.4.2.6 Modify USERFILE 


All sites connected by uucp must modify the file /usr/lib/uucp/USERFILE. This is where 
uucp looks when another system announces it has work to do on your system. Uucp uses 
USERFILE to double-check that the system is allowed on your machine and to find out 
what that system is allowed to do. Even if you never receive calls from other systems, you 
still have to change the USERFILE, so that you can control what the slave sites can do 
during that portion of the conversation when they execute their jobs on your system. Like 
L.sys, the USERFILE is confidential, and should have access mode 400. 


Lines in USERFITLE have the form 


login ,remote_nodename [c] pathname(s) 


where 

login the login name you assigned to the caller. This must be followed by 
a comma. 

remote_nodename the nodename of the caller. If this field is blank, then the fine 
applies to anyone with the same login name. 

c optional field, which designates that callers should be called back to 
confirm their identity. If you are not set up to call out, you 
shouldn’t specily this. 

pathname(s) the directories to which the remote user has access. 


If the system “‘pip”’ calls you, and you have given them the login name ‘‘SysPip’’ and you 
don’t want to call them back, and you want them to have minimal access to your system, 
your USERFILE line for them should read 


SysPip, pip /usr/spool/uucppublic 


USERFILE must contain a line for the user uucp in order to perform remote functions. 
Yhat line might be 


uucp, /usr/spool/uucppublic 


USERFILE must contain directory access permissions for local users in addition to remote 
ones. You need at least one line that applies to your own site. If you don’t put this line in 
the USERFILE, then local users may perform no uucp work at all; you receive the message 
ACCESS (DENIED) in the LOGFILE lor all your local users’ jobs. 


Remember that all the ordinary access permissions continue to apply in uucp transactions. 
Therefore, a USERFILE line such as 


,/ 


would preserve exactly the current access permissions for all your current users. Although 
this line does not specify a login, it does NOT permit anybody to do anything on your sys- 
tem. Remote callers must have a line that matches their login name and nodename exactly; 
the line ** , /” does not match any remote caller. 


10.4.2.7 Implementing Automatic Calling 
If you want to call another site regularly and automatically, you need an ACU and some 
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way of regularly executing a shell procedure to start up uucp. ‘he latter is usually accom- 
plished by putting an entry in /usr/lib/crontab. 


For example, suppose you want to link every hour. You first need a shell procedure to 
establish the link. Then you name that shell procedure in crontab with instructions to exe- 
cute it every hour. 


For the shell procedure, two simple lines like the following will do: 


/usr/bin/uutog 
/usr/lib/uucp/uucico -r!. -s<system_nodename> 


The angle brackets around the system_nodename are not part of the syntax; they are just a 
signal to you to substitute here the name of the system you want to call. So if you want to 
call nodename plx, this line would read 


/usr/bin/uulog 
/usr/lib/uucp/uucico -r1 -splx 


/usr/bin/uulog wakes up the uucp log, so these transactions will be properly recorded. It 
puts its record in the file /usr/spool/uucp/LOGFILE. Uucico is the name of the program 
that performs all the transfers. 


Suppose you name this shell procedure “hour” and put it in the directory /usr/lib/uucp. 
Don’t forget to chmod it to make it executable. Then, to get it to execute every hour (e.g., 
at 20 past the hour), the line in crontab would read 


20 * * * * /usr/lib/uucp/hour 


For more information. see cron(1). 


10.4.2.8 Optional Procedures 


The following two procedures are optional but recommended if you will be automatically 
calling other sites. ‘hese are uucp system administrator tasks; ordinary uucp users do not 
have to know about them. 


10.4.2.8.1 Purge the Logs 


If you communicate via uucp often, you may want to set up automatic purging olf the file 
/usr/spool/uucp/LOGFILE. This file contains records of transactions over uuep; every exe- 
cution of uucico is recorded, along with information about whether or not the call suc- 
ceeded, what problems were encountered, and what jobs were done. If you cail just one 
other site every hour with minimal activity (mail only), the LOGFILE can grow as large as 
40K bytes per week. If you run news, the log is routinely over 500K bytes per week. So 
you can see the need for keeping its size under control. To purge the LOGFILE, execute 


cp /usr/spool/uucp/LOGFILE /usr/spool/uucp/o. LOGFILE 
rm /usr/spool/uucp/LOGFILE 


You'll probably want to make this a shell procedure. Note that this procedure always saves 
the last LOGFILE if you need to refer to it. Suppose you want to do this weekly, so you 
call this [ile ‘“‘week’’. You put it in /usr/lib/uucp and make it executable. Then, this shell 
procedure can be automatically invoked weekly by a crontab entry such as the following: 
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30 5 * * f /usr/lib/uucp/week 
This executes the file /usr/lib/uucp/week at 5:30) AM on Monday mornings. 


The same considerations apply to the file /usr/spool/uucp/SYSLOG, but with fess urgency. 
Tf you run news, the file /usr/lib/news/log should also be cleaned up every few weeks. 


10.4.2.8.2 Remove Unused Job and Lock Files 


Finally, you may want to remove on a regular basis job files that are queued but for some 
reason (e.g., line problems, login problems) were never sent or never sent completely. 
These include temporary data liles (prelix TMP), copy files (prefix C) and data tiles (prefix 
D). You may not have any of these in your /usr/spool/uucp directory: they come into 
existence when uucp starts operating. Read more about these in the regular UUCP docu- 
mentation if you need to know about them. 


You may also want to remove those files that prevent uucp transmissions from taking place: 
system status files (prefix ST), and lock files (prefix LCK). The status liles have the form 
STST.sys”, where sys is the nodename of the system you are trying to call. They are 
created when ordinary failures take place, such as encountering a busy line. ‘They prevent 
repeated tries for about 55 minutes. They are important because if you want to start uuep 
manually before the 55 minutes are up, vou must lirst remove the ST file for the system 
you are calling. Since any user can start up uuep. any user can delete S1' files. 


Lock files prevent the device you are using from being accessed by another user while uucp 
transmissions are taking place. If the system crashes during transmissions, these files may be 
left in the /usr/spool/uucp directory and inhibit any further activity on the device until they 
are removed. Therefore. check for these and remove them if you find you are unable to 
make a connection. 


The program uuclean removes unwanted files and sends mail to root and to the user whose 
job was lost. To have the uuclean performed regularly. a shell procedure like the following 
can be used: 


/usr/lib/uucp/uuclean -pTM -pC., -pD. 
/usr/lib/uucp/uuclean -pST -pLCK 


The -p option means remove ail [files with this prefix. The uuclean program automatically 
removes files older than 72 hours. You can change the number of hours a file must age 
with a -n option to the uuclean command: for example, -n12 for 12 hours instead of 72. If 
you want this performed daily, you can name the lile “day’’, make it executable, and put it 
in /usr/tib/uucp. Then you need a line in crontab like the following: 


0 20 * * * /usr/lib/uucp/day 
This executes the “day” program every day at 8 PM. 
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THE STANDALONE ENVIRONMENT 


Standalone programs are programs that run independently of UNIX. Such an environment 
is sometimes required for Sys3 UNIX to create, alter, or repair the environment in which 
UNIX Sys3 runs. Under certain circumstances you could not change the Sys3 environment 
without disabling the operating system (and your accumulated files and programs) at the 
same time. Programs of this category alter or maintain the organization and/or format of 
the disk drive(s). 


Some Sys3 UNIX standalone utilities are provided, not to alter the environment, but to 
check system status of various parameters while the system is “down.” Others provide 
device-to-device copying, backup, and/or restore capabilities when it is inconvenient or 
impossible to bring the system up to single-user or multi-user mode lirst. 


Although you will frequently run the Sys3 versions of several standalone programs 
described in this chapter such as cat and Is you will rarely find it necessary to invoke the 
standalone environment. 


You will definitely need to invoke standalone programs, however, if you: 
© Install a new disk 
© Experience a catastrophic disk failure 
® Increase the swap area or change its location 
© Spare some bad disk tracks 
* Implement more than two file systems on your disk 
* Change the default logical disk sector addresses on the disk 
Notice that most of these examples are once-per-system occasions. 


This chapter explains what these standalone programs do and gives general instructions for 
their use. 
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Plexus release tapes contain some or all of the following files. The number in parentheses 
before the name indicates the position ol the file on the release tape. 


(0) help 
(1) boot 
(2) sys3 
(3) dformat 


(4) mkfs 
(5) restor 
(6) fsck 

(7) dd 

(8) fbackup 


(9) od 
(10) deonfig 


(11) RESERVED 
(12) fsdb * 
(13) du * 

(14) Is * 

(15) cat * 


Gives information about the release tape and use of standalone programs. 
Secondary boot. Loads requested program into memory and executes it. 
A binary copy of the Sys3 UNIX operating system kernel. 


Disk format. Formats a disk drive, prompts for format information, 
enables sparing of bad disk sectors. 


Make file system. Creates and organizes a bare lile system. See MKFS(1). 
Restore file system [rom dump tape. See RESTOR(1). 
Interactive file system consistency check. See FSCK(1). 
Device-to-device copy program. Can read out of file systems. See DD(1). 


Fast backup. Does a quick image copy from disk to tape or [rom tape to 
disk. 


Octal dump. Dumps a file to the screen in octal or hex format. See 
OD(1). 


Configures a disk with initialization information and the logical file system 
layout lor Sys3 UNIX. 


File system debugger. See FSDB(1). 
Reports disk usage. See DU(1). 
Lists contents of directories. See LS(1). 


Concatenates and prints files. See CAT(1). 


A lew general remarks about standalone programs: 


1. NEVER run the standalone version of a program while UNIX is booted. 


2. Standalone programs cannot create or write to regular disk files, although some can 
write special files. 


3. Standalone programs do not allow redirection, pipes, or pattern matching on the com- 


mand line. 


4. Tf you make a mistake when you type in the program name, # or <backspace> 
erases One character; "@" or <control-x> erases one line. 


5. ‘The delete key or rubout key aborts a running standalone program. 


* 


These standalone programs are in the /stand directory on disk. but may not be included in your tape copy of 


standalone programs. 
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11.1 How to Run a Standalone Program 


Most standalone programs can be run either from tape or from disk. This means you can 
use either the copy of the program that resides on tape or the one on disk. (Naturally, if 
your disk is bad, you will use the tape version of the program; this is the point of having 
two copies.) Disk standalone programs reside in the directory /stand. 


To run any standalone program (or any program), you must name it unambiguously. 
Therefore, some conventions are in force to specify program names. For historical reasons, 
two formats work — one longer, one shorter. The longer command format is required 
only in very unusual circumstances — e.g., if you have two programs with the same name 
on a tape, and you need to distinguish between them. The longer method is never neces- 
sary lor disk resident standalone programs. 


The Longer Method 


Programs may be specified by a pathname of the form: 


device (number, offset) program_name 


where 
device is a device specifier — pt is tape, pd is disk. 
number is a device number (trom 0 to 3). 
offset is the starting point (in files for tape, sectors for disk). For disk 


files, offset is the offset of the file system that contains the program, 
not the offset of the program itself. 


To call disk-resident programs, you use the “device (number, offset)’’ prefix, specifying 
both the starting address of the file system that contains the program, and its complete 
pathname. This prefix is not always necessary to call tape-resident programs. For example, 
no ambiguity in naming can result if you run the standalone programs from the Plexus 
release tape, since Plexus release tapes do not duplicate program names. In this case you 
can omit the pathname: if you use the Plexus tape version, you can just mount the tape, 
obtain the primary boot prompt. and type the program name. 


Thus, using this method, to execute the standalone program mkfs from the release tape, 
only the program name must be typed in response to the boot prompt. (The boot prompt is 
PLEAUS PRIMARY BOOT REV X.X, where X.X is the revision number.) So to exe- 
cute the tape resident program, the sequence is 


PLEXUS PRIMARY BOOT REV X.X% 
: mkfs 


However, if you had two programs named mKfs on the tape (something that would never 
happen on a Plexus release tape), you would have to specify which one you wanted. To 
specify one at offset 10 (the tenth file on the tape) on tape unit 0, you would type 


PLEXUS PRIMARY BOOT REV X.X 
> pt(0,10)mkfs 


To execute this same program from disk, the long method requires 
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PLEXUS PRIMARY BOOT REV X.X% 
: pd(0,0)stand/mkfs 


In this example, pd indicates a disk device (pd is driven by the IMSP disk controller, (0,0) 
indicates disk unit O at offset O, and stand/mkfs indicates the pathname of a file within a 
file system starting at this location. 


The Short Method 


All P/35s permit truncating both the tape and the disk-program names; the slash (/) as the 
first character in the pathname is a sort of shorthand the system understands to mean 
/dev/dk0, which means the program is disk resident. (You may, of course, give the whole 
longer-style pathname, too.) 


Thus, to execute the standalone program mkfs from the release tape, only the program 
name must be typed in response to the boot prompt. So to execute the tape resident pro- 
gram, the sequence is 


PLEXUS PRIMARY BOOT REV X.X 
mkfs 


To execute the same program [rom disk, the short method allows just 


PLEXUS PRIMARY BOQT REV X.X 
/stand/mkfs 


The slash (/) indicates that stand is on the disk. 


Most of the standalone programs have counterparts described in the Plexus Svs3 UNIX 
Programmer's Manual —- vol 1. When called, the standalone programs all return a double 
dollar sign ($$), instead of the usual single dollar sign, followed by the program name. 
The cursor is positioned one space to the right of the program name. You type arguments 
to the program there. For example, if you type 


pd(0,0)stand/dd 
or 
/stand/dd 
the system responds 
$$ dda 


where © represents the cursor. 


Thereafter, the arguments to the standalone programs are usually the same as described in 
the Plexus Sys3 UNIX Programmer's Manual — vol 1. 


The standalone programs that do not follow the Volume 1 formats are generally interactive; 
that is, they prompt for any parameters needed. 


Upon completion, standalone programs print "Exit" followed by a value. The value "0" indi- 
cates that the program completed normally. 
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11.1.1 Standalone Programs and Special Files 


The following special files can be used as arguments to the standalone commands: 


/dev/dkXX Logical disks on default physical disk(s). 


/dev/pdXX Logical disks on IMSP physical disk(s). XX ranges in value from 
0 to 15 for disk unit 0 (pd(0,0)), 16 to 31 for disk unit 1 
(pd(1,0)), 32 to 47 for disk unit 2 (pd(2,0)), and 48 to 63 for 
disk unit 3 (pd(3,0)). The disk addresses of the logical disks are 
listed in Section 11.3, ‘‘dconfig.”” For more on logical disks, see 
the account of mkfs below and in the chapter, “Configuring 
Disks.”” (The logical disk addresses may be changed by the stan- 
dalone program dconfig.) 


/dev/mtO Detault tape. 

/dev/nmt0 = Default tape with no rewind. 
/dev/pt0 IMSP cartridge tape. 

/dev/npt0 IMSP cartridge tape with no rewind. 
/dev/null The bit bucket. 


The following restrictions apply to the use of these special files in standalone programs: 


1. 


2 


ae 


3. 


The initial access to an TMSP tape (device ‘pt’) rewinds it before reading or writing it. 
Writing to an TMSP tape (device ‘pt’) must be in multiples of 512 bytes. 


Standalone programs automatically buffer read requests [rom special files; the bufler 
size 1s 1024 bytes. Thus read requests lor less than 1024 bytes result in 1024 bytes 
being allocated per read anyway. 


Writing to any of the special disk files (/dev/dkXX or /dev/pdXX) must be in blocks 
of 1024 bytes per write. Thus the command 


$$ dd if=/etc/rc of =/dev/dk2? obs= 1024 


must include the ‘obs= 1024 argument. 


Once a cartridge has been rewound, writing to it can overwrite data on it even if you 
try to skip to the last [ile on the cartridge. See pt(4) in the Plexus Sys3 UNIX 
Programmer's Manual — vol 1. 


The standalone commands normally use /dev/dk1 as the root [ile system. This can be 
changed by changing the rovtdev, pipedev, dumpdev, and nswap values in block 0 of 
/dev/dk1. See the description of the deonfig standalone command in this manual. 


11.1.2 The Mount and Skip Commands 


The standalone commands recognize two special built-in commands that set up their 
environment. These are mount and skip. Mount allows access to disk files on file systems 
other than /dev/dk1. To use it, type an exclamation point (!) followed by a mount com- 
mand in response to the standalone prompt $$. For example, to concatenate files on a Tile 
system on /dev/dk2, (user response in bold): 
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$$ cat ! /dev/dk2 /fs2 
<ctl-d> 
$$ cat /fs2/user/foobar 


Note that typing <ctl-d> causes a reprompt of $$ followed by the command name. 


The skip command allows direct access to particular files on tape: it positions the tape at 
the beginning of the file number you specify. To use skip, type an exclamation point (!) 
followed by the skip command in response to the standalone prompt $$. For example, to 
concatenate tape file 3 (user response in bold): 


$$ cat ! skip /dev/nmt0 3 
<cti-d> 
$$ cat /dev/mt0 


Note that entering <ctl-d> causes the reprompt $$ [followed by the name of the command. 
Note also that the skip command requires /dev/nmt0 rather than /dev/mtQ — using the 
latter would rewind the tape before the second prompt. 


11.2 What Standalone Programs Do 


This section describes in detail the functions of all the standalone programs, with special 
emphasis on the non-trivial standalones that create or alter the disk environment for Sys3 
— dformat, dconfig and mkfs. 


11.2.1 dformat 


dformat is the controlling program lor formatting hard disks. Formatting involves encoding 
the disks’ magnetic surface with boundaries so the operating system can find byte patterns 
to read or blank spaces to write to. Each disk is divided (encoded) into tracks and sectors. 
Tracks are magnetic patterns of concentric circles on the disk surfaces. Tracks are divided 
into sectors. 


To the user, sectors have 512 bytes each, but actually, dformat “knows” that each sector is 
larger than 512 bytes by about 15%. This larger figure is known as the “actual bytes per 
sector,”” and it varies according to the disk controller and disk drive installed in your sys- 
tem. For example, a disk might actually have 586 bytes per sector. The extra 72 bytes 
(beyond 512) provide the disk controller hardware and lirmware the pointers and addresses 
it needs to mark the beginning sector data. 


A microscopic flaw in the magnetic coating on a disk can prevent the operating system 
from reading or writing to the sector(s) or track(s) that share disk space with that flaw. 
When this happens, that track or sector must be “spared.”’ That is, to keep the disk usable, 
the operating system must be inlormed that that track or sector is bad. Then it can set up a 
new area of the disk to substitute lor the bad part, remap the disk to skip the bad and seek 
the substitute sector or track. 
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The standalone program, dformat, performs both types of disk preparation and mainte- 
nance routines: initial setup and formatting, and sparing —— either automatic or manual. 


The main purpose of dformat is to set sector size, number of sectors per track, number of 
alternate cylinders or tracks, etc. Like any operating system, Sys3 can only access its disk 
by sectors. It must know exactly how large these sectors are in order to transform block 
requests into sector requests. Once the sector size and other issues have been decided, 
dformat goes out and defines sectors on the disk, writing sector headers lor each sector. 
These headers make the sector able to identily itsell to the disk controller — and ultimately 
to Sys3 =~ when the sector is accessed. so the system can be sure it’s getting the right one. 


dformat can also perform disk tests and repairs: it finds out if the disk can write data, and 
whether the disk can read what it writes. If dformat finds a sector it can’t read or write, it 
automatically spares it. Tt sets up a bad-sector table such that any requests to access a bad 
sector are automatically redirected to a good sector. You can also use dformat to manually 
spare any bad tracks or sectors reported by a Sys3 error message. 


Dformat has several options. Not every option is available on every Plexus machine. 


f Format the disk. ‘The formatting operation has two phases: format and test. The for- 
mat part consists of writing sector headers, and writing the user pattern on the disk. 
The test portion consists of reading the user pattern just written, looking for unread- 
able sectors, and sparing any unreadable sectors it finds. Error messages of the form 


track <cylinder>/<head> spared 


are printed for all bad sectors found and spared. 


s Spare tracks. Enables manual (i.e., operator intervened) sparing of tracks. 

r Read the disk, performing only a surface analysis. Does not re-format or spare bad 
tracks. This option generates and prints a report of the bad tracks on the disk, in the 
form 


bad trk <cylinder>/<head> 
This option is available only on disks with IMSP controllers. 
l List bad tracks. This option prints a table of all the bad tracks (pd) and their 
corresponding spares, in decimal and hex. 
Only one of these options can be requested per invocation of dformat. 
NOTE 


dformat spares disks controlled by the IMSP by whole 
tracks. If there is a bad area on the disk, it remaps to one of 
twenty alternate tracks. 


Dformat with the [ option rewrites the disk’s sector headers. These are written by Plexus in 
the factory and should never have to be rewritten. The [ option should be used only alter 
consultation with Plexus field service (hardware maintenance) personnel. In most cases, no 
matter how badly the file system has been scrambled, the disk can be completely restored 
by the use of dconfig, mkfs, and restor in that order. 
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Dformat with the { option writes a pattern of bits all over the disk, so any previous contents 
of the disk are lost. If the disk still has good data on it, back it up before running dformat 
with the f option. 


The default sector size is 512 bvtes: the default block size is 1024 bytes. The following 
table gives the normal total number of 512-byte sectors created by dformat on Plexus disks. 


TABLE I1f-1. Votal Sectors on Plexus Disks 


Total Available Sectors on Plexus Disks 
Disk Size IMSP (pd) 

22 Mb 8" 40290 

36 Mb 8" 67150 


72 Mb 8" 135422 
142.6 Mb 8" 272544 
72 Mb 14" 136510 
145 Mb 14" 273020 
289 Mb 14" 546176 


The total number of 1K-byte [ile system blocks can be calculated by dividing each sector 
count above by 2. 


11.2.2 mkfs 


The standalone program, mkfs, like its /ete/mkfs counterpart. creates file systems. It 
declares that a certain range of disk addresses is to be considered a file system, and sets up 
special disk blocks — the superblock, the free list, and the i-list — within that file system 
for UNIX to maintain housekeeping information about the files within the file system. 


The special blocks contain information such as how many files are in the file system, how 
many blocks are free, where files live on the disk, and how big they are. The tile system 
created by mkfs is empty and is organized as illustrated in Figure 11-1. 
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block 
0 information block 
l superblock 
2 
2+ i-size 
data, 
indirect, 
and free 
blocks 
file size 


Figure It-1, mk{s File Organization 


In Figure 11-1, “isize’” is the length of the i-list, and “file size’’ is the length of the file sys- 
tem. For more detailed information, see the article “FSCK” in the Plexus Sys3 UNIX 
Programmer's Manual — vol 2B. 


When creating mounted file systems (i.e., file systems other than the root file system), you 
can run /ete/mkfs under UNIX or mkfs of the standalone environment. When creating the 
root file system, however, standalone mkfs must be used because it prepares a file system so 
Sys3 and its utilities (the root file system) can be restored from tape onto the disk. Plexus 
has already run standalone mkfs on the root file system, so you will not need to run this 
version unless you alter the default size or location of the root file system or the swap areaz 


Because mkfs re-initializes the superblock and i-lists, any data that is already on the logical 
disk, though not overwritten, becomes inaccessible, since UNIX loses all pointers to it. 
Therefore mkfs must be used with caution. 


After you run mkfs and before you mount(1) the file system you made, it’s a good idea to 
run fsck on the new file system, to insure the integrity of the file system. 


11.2.3 dconfig 


dconfig is a rather comprehensive program that determines several disk and system factors. 
You can run dceonfig to obtain or change the status of any of the following parameters: 
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e The disk identification (id) 
e The kernel name (primary bootname) 
e An alternate kernel name (secondary bootname) 


e Disk information specific to the actual disk unit installed. including number of 
cylinders, sector size. sectors per track, etc. 


e Your system’s node name (if you want to give your system a name to put it on a uuep 
network ) 


e Which logical disk will contain the root file system and perform pipes and dumps 


Which logical disk will provide the swap area 
e fhe address and size of the swap area 
e The boundaries and default start addresses of each potential logical disk 


These parameters are vital to the system. Some parameters (such as disk cylinders, sector 
size, etc.) have no alternate values for your system. Changing them simply disables your 
system. 


The other parameters can be changed if done carefully and consistently, such as the device 
numbers for root, swap, etc., the swap size and location, and the start addresses of the logi- 
cal disks. 


Changing your nodename will not affect internal system performance, but other nodes on 
your uucp net must be notified if vou still want their messages to “find” your system. 


You can run ete/deonfig or standalone dconfig to /ovk at the status of any of the parameters 
previously mentioned. You should run standalone dconfig, however, to change any of the 
parameters. You will most likely invoke standalone deonfig to perform the following func- 
tions: 


1. Create a Sys3 node name for uucp 
2. Enlarge or relocate the swap area 
3. Divide your disk into 3 or more file systems 


The procedure for the first function 1s contained in the chapter, “Implementing UUCP.”’ 
Procedures for performing numbers 2 and 3 are contained in the chapter, ““Conliguring 
Disks.” 


Because dconfig is so comprehensive, the following page displays the prompts you will see 
when running it. The responses in bold show the default values or factory settings according 
to the type of system you have. 


Early P/35s” are P/35s shipped with Sys3 version 3.13 or earlier. They have a default swap 
area of only 2 Mb, and should probably be enlarged according to the swap increase pro- 
cedure in the chapter, *Conliguring Disks.’’ ""New P/35s” are systems shipped with Sys3 
version 3.2 or later. New P/35s have a 6 Mb swap space and a 24 Mb sized /dev/dk!. 
P/35’s shipped with the smallest disk (22 Mb) have a 4 Mb swap area and retain the 20 Mb 
size of /dev/dk!. 


The responses marked by an asterisk (*) vary widely; the range of responses are indicated 
in Tables 11-2 and 11-3 that follow the deonfig display, below. 
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: deonfig 

$$ dconfig 

Disk? : /dev/dkO 
Disk id? [pd]: pd 
Primary bootname? [/sys3] Isys3 
Secondary bootname? []: <return> 
Number of cylinders? [0]: * 

Number of heads on removable? [0]: 0 

Number of heads on fixed? [0]: * 

Data bytes per sector? [0]: 512 
Sectors per track? [0]: * 

Number of alternate cylinders? [0]: 20 

Fite system blocksize? [0]: 1024 

Sys3 nodename? []: <return> 


Change the default unix device mapping? [y/n]: —y 


[The following six items appear only if you answer ‘ty’. You may confirm with carriage return. Change these 
only if you really know what you're doing. | 


Early P/35s New 22Mb P/i35s — New P/35s 


Rootdev? [0x0]: 0x1 same same 
Pipedev? [0x0]: Ox! same same 
Dumpdev? [0x0]: 0x1 same same 
Swapdev? [0x0]: 0x1 same same 
Swplo? [0]: 36000 32000 36000 
Nswap? [0]: 4000 8000 12000 


Change the file system disk configuration? [y/n]: sy 


[The following sixtcen lines appear only if you answer “ty”. You may confirm the default valucs by carriage 
returns. | 


File system logical configuration? [sector start.sector count] 


Early and 

22 Mb Pi35s New P/35s 
dkO [0,0]: 0 0,7 
dki [0,0]: 0.40000 0,48000 
dk2 [0.0]: 40000,” 48000,” 
dk3 [0,0]: 60000,” 68000." 
dk4 = [0,0]: 80000,” 88000,” 
dk5S  {0,0]: 100000,” 108000,” 
dk6 = [0,0]: 120000,” 128000,” 
dk7 [0,0]: 140000, 148000,” 
dk8 [0,0]: 160000,” 168000,” 
dk9 [0,0]: 180000,” 188000,” 
dk10 [0,0}: 200000,” 208000,” 
dkI1 [0,0}: 220000,” 228000,” 
dki2 [0.0]: 240000,” 248000,” 
dk13_ [0,0]: 260000,” 268000," 
dk14 [0.0]: 280000," 288000,” 
dkt5 [0,0]: 300000,” 308000,” 
Is the above information correct? [y/n]: y y 
Are you sure you want to rewrite block 07: sy y 
Block 0 of [pd](0,0) initialized successfully! 
Exit 0 


PLEXUS PRIMARY BOOT REV X.X 


The dconfig prompts for number of cylinders and for number of ltixed heads varies accord- 
ing to which disk is installed in your P/35. Use the following tables as guides for inserting 
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the proper values for the asterisk prompt in the deonfig program. 


TABLE 11-2. TMSP Fujitsu Responses 


Controller IMSP 


Disk Model 14" 
72Mb 
Fujitsu 

Unit pd(0,0) 

# of cylinders 823 

# removable heads 


# lixed heads 


Data bytes per sector 


Sectors per track 


# alternate cylinders 
Interleave factor 
User pattern 

File system block size 1024 


Default boot name /sys3 
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ad5asasa5 


IMSP 
14” 
145Mb 
Fujitsu 


pd(0,0) 


823 


a5a5asas 
1024 


/sys3 


IMSP 
14" 
289Mb 
Fujitsu 
pd(0,0) 
1024 


0 


a5a5a5as 


1024 


/sys3 
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IMSP 
8" 
72Mb 
Fujitsu 


pd(0,0) 


589 


a5a5a5a5 
1024 


/sys3 
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TABLE 11-3. [MSP NEC Responses 


Controller IMSP IMSP IMSP 

Disk Model NEC NEC NEC 
8" 8" 8" 
22Mb 36Mb 142.6 

Unit pd(0,0) pd(0,0) pd(0,0) 

# of cylinders 415 415 1024 

# removable heads 0 0 0 

# lixed heads 3 5 8 

Data bytes per sector 512 512 512 

Sectors per track 34 34 34 

# alternate cylinders 22 22 22 

Interleave factor l 1 1 

User pattern aSa5a5a5—aSa5a5a5—— a5 aSa5a5 

File system block size 1024 1024 1024 

Default boot name /sys3 /sys3 


11.3 fsck 


Fsck is a file system consistency checker like the V7 utility icheck, but fsck is more power- 
ful and easier to use. The document "FSCK"” in the Plexus Sys3 UNIX Programmer's 
Manual — vol 2B describes in great detail what fsck does and how it works. Standalone 
fsck can check a maximum Of five file systems per invocation. 


11.4 restor 


The standalone program restor is the partner of dump. [t puts the contents of dump tapes 
back onto the disk. Dumps are designated as full or incremental. A full dump either puts 
the entire file system on tape. An incremental dump puts on tape all the components of 
the file system that have been altered since the last dump. See the relevant pages of the 
Plexus Sys3 UNIX Programmer's Manual — vol ] for further information. 


Standalone restor works as described tn the Plexus Sys3 UNIX Programmer's Manual — vol 
/ with the following differences. 
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1. The x key is not supported. 


2. An argument of the form "+ <file no>,” where <file no> is a positive integer, may 
follow the last argument. ‘This directs standalone restor to skip over <lile no> 
number of files on tape before doing the restore from tape. For example, the 
sequence below (user response in bold) spaces forward 20 liles on tape belore starting 
the restor. 


$$ restor r /dev/dk1 +20 
Spacing forward 20 files on tape 
Last chance before scribbling on /dev/dk1 <return> 
End of tape 


A few things to remember about using restor: 


e The file system being restored must exist on the disk. Restor does not create a file sys- 
tem; if the file system does not exist, you must use mkfs to create the file system belore 
running restor. 


e Like dump, restor works in terms of lile systems. herefore, it's hard to retrieve single 
files {rom a dump tape. If you’re interested in archiving single files, you should use 
either tar or cpio. 


e Restor replaces the previous contents of the file system. Be sure you don’t care! 


11.5 dd 


This program works as described in the Plexus Svs3 UNIX Programmer's Manual — vol 1. 
See the section on backups in the chapter, “Periodic System Routines,” for an explanation 
of how dd fits in with the other Sys3 programs that do tape I/O. 


11.6 fbackup 


Fbackup is a fast, standalone Plexus program that copies from disk to tape, or tape to disk, 
in streaming mode, blocking [iles at 32 disk sectors per tape record. 


See the section on performing backups in the chapter, ‘Periodic System Routines,” for an 
explanation of how fbackup [its in with the other Sys3 programs that do tape V/O. 


Fbackup is faster than dump and writes in a format that is understood by dd, so you 
should use fbackup rather than dump if you need the speed. 


‘Yo use fbackup, you need to know the starting disk address of the [ile system, and its 
length in 512-byte disk sectors. If you have created your file systems (with mkfs) so they 
correspond to deonfig’s predefined logical disk sizes, you can determine the starting disk 
address and length of each file system by running /stand/dconfig. If you have used mkfs to 
change the file system sizes so they no longer correspond to the defaults listed by dconfig, 
then you may still use the numbers reported by deonfig. Fbackup will do its job anyway: 
your file systems cannot in any case be larger than the logical disk sizes reported by 


Page 11-14 Plexus Computers 


P/35 User's Manual The Standalone Environment 


dconfig, and fbackup does not mind if the lile system size figure is larger than the size of 
the actual file system. (You will have trouble only if you have changed the file system sizes 
to larger than standard values without having increased the default logical disk sizes.) 


11.7 Other Standalone Programs 


Plexus provides standalone versions of the following commonly used UNIX commands. 
These all work as described in the Plexus Sys3 UNIX Programmer's Manual =- vol |. 


fsdb a file system debugger. 

od octal dump. It allows dumping of a file in various octal, decimal, or hex formats. 
Tt is mainly a debugging tool. 

Is list files and directories. 

cat concatenate and print. 

du reports disk usage. 

11.8 help 


Information about the release tape is displaved on the system console by the help program. 
Tt is self-explanatory and makes use of menus to allow access to more detailed information. 
To use the help program, load the release tape into tape drive 0 and. In response to the 
boot prompt, type either °°?” or help. 


11.9 boet 


This standalone program ts not normally used, since the primary boot in firmware performs 
the same function. No special operator instructions are required. 


11.19 sys3 


Under normal circumstances, this copy of the Sys3 UNIX operating system ts never 
accessed. It is included only as a last-resort backup in case all other copies have been lost. 
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PERIODIC SYSTEM ROUTINES 


Most system administration duties are performed once-only (e.g., setting up the disk, instal- 
ling uucp, etc.) or as-needed (e.g., adding new accounts, recovering from a crash, etc.). 
There are some duties, however, that must be performed on a regular basis ranging from 
daily to biannually. These duties are of two main types: tape backups, and maintenance of 
the physical condition of the computer itself. 


Tape Backups 


You must make some sort of tape backup daily, even if it records only the changes made in 
the file system(s} from the previous day. This could take the form of an incremental dunip 
or selective archiving of active user files. You should also ensure that the system receives a 
complete backup at least once per week. 


In addition, some installations dump all the file systems onto tape and then restor them on 
a regular basis (monthly, quarterly, or annually, depending on how much frequent disk I/O 
degrades overall performance). As a disk drive is accessed, the system does not necessarily 
put files back in exactly the same physical location as where it got them. Over a period of 
time, the file system loses its physical contiguity. While the system can still find the files, 
they become more spread out. slowing disk access time. A full dump and restor reorders all 
the files contiguously, which restores performance to the original level when shipped from 
Plexus. 


Physical Maintenance 


Plexus computers are built to work reliably in a wide variety of environments, but they still 
require daily, monthly, and biannual routines to prevent dirt, friction, or wear from 
impairing system performance. These routines require cleaning or replacing components or 
filters on the periodic bases described in the subsection of this chapter, **Preventive Mainte- 
nance.” 


12.1 Batkups 


Several Sys3 programs can put Sys3 files on tape: tar, cpio, dd, fbackup, volcop¥, and 
duMp. These programs have different purposes. tar, dd, and cpio allow selective archiving 
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of files. tar is dedicated to tape archiving, while cpio is more general: it writes to standard 
output that can be redirected to a tape device. Both tar and cpio permit limited manipula- 
tion of tape record size. dd can perform EBCDIC-ASCTI conversion, and allows very flexi- 
ble specification of tape record size. dd, tar, and cpio allow you to specify exactly which 
files you wish to move. With different options, they also allow you to retrieve files selec- 
tively; e.g., you can mount a tape and tell these programs what [iles you want to retrieve. 


dump, volcopy, and fbackup, on the other hand, are for backing up whole file systems. 
dump either puts the entire file system on tape, or puts on tape all the components of the 
file system that have been altered since the last dump. The first type of dumps called a [ull 
or level 0 dump. The second dump (archives only components that have changed) is called 
an incremental or level 9 dump. 


fbackup is a fast, standalone Plexus program that coptes [rom disk to tape, or tape to disk, 
in streaming mode, blocking files at 32 disk sectors per tape record. 


volcopy makes a literal copy of the lile system using a blocksize matched to the device. 
The volcopy liles may include labels. 


The following table outlines the differences among these programs: 


TABLE 12-1. Sys3 Programs that Write to Tape 


Usage Notes | Restore 


Remarks 


Program 
= = 
dump For use on [ile systems. Standalone 
Allows both complete & | restor 
incremental dumps. 
For use on files. T pio 
Writes to standard 


output. 


Does not 
handle multiple 
tape volumes. 
Standalone. 
Does not 

handle multiple 
tape volumes. 


For use on files. 


For use on [iles 
and file systems. 

Does data conversion. 
Good for [/O on 

raw devices. 

Same format as fbackup 
if bs=32b. 
For use on file systems. 
Fast. 

Same format as dd. 


Standalone 
only 


fbackup 


See the relevant pages of the Plexus Svs? UNIX Programmer's Manual — vol | lor turther 
information. 


For use on file systems. 
Uses labels. 
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The standalone program restor is the partner of dump. It puts the contents of dump tapes 
back onto the disk. 


12.1.1 Performing Backups with fbackup 


This program copies [rom disk to tape or from tape to disk while using the tape in stream- 
ing mode. It blocks files at 32 1024-byte blocks per record. 


For example, to copy a [ile system that is 20000 sectors long (512-byte sectors), starting at 
offset 40000 on disk drive 0, onto the tape in tape unit 0, respond to the boot prompt as 
indicated in bold: ; 


PLEXUS PRIMARY BOOT REV X.X 
: fhackup 


This program will then prompt for the location of the file system (in this example, the first 
20000 sectors of dk2). 


$$ ftbackup 

Backup to tape or Restore from tape? [br]: b 

Disk unit? [is(0-3,0)] or [pd(0-3,0)]: pd(0,0) 

Tape unit? [rm(0-3,0)] or [pt(o0,0)]: 0 

Starting disk block number for backup/restore? [0,111719]: 40000 
Number of blocks in backup/restore? [1,67720]: 20000 

Disk reads complete! 

Backup to tape completed successfully 

Exit oO 


PLEXUS PRIMARY BOOT REV X.X 


The numbers in brackets in the Starting disk block number and 
Number of blocks lines depend on the controller type and disk type. See the 
tables under "Disk-Dependent Responses" in the chapter, “The Standalone Environment” 
for the correct values. This tape can be restored using the fbackup program or by using the 
Sys3 UNIX command dd(1) with bs=32b. 


12.1.2 Using dump for Backubs 
This section describes how to create backup tapes using the command dump. 


The d4mp command provide a system for making routine archive tapes which can then be 
used to recover entire lile systems if data on the disk is damaged or lost. 


12.1.2.1 Scheduling Dups 


A rigidly enforced schedule of dumps (i.e. making backup tapes) provides the best 
insurance against lost data. 


There are two levels of dump: full and incremental. A full dump copies everything; an 
incremental dump copies only those [iles changed since the last dump was taken. 
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A typical schedule requires: 

a. taking an incremental dump alter every working day, 

b. taking a full dump alter work on Fridays. 
Quarterly, you might also want to take a full dump and then restor the file systems to disk 
to maintain system disk I/O performance. 


The tapes made for archival purposes are stored and used in rotation so that the oldest tape 
is always the next used. Incremental dump tapes are saved at least a week and {ull dumps 
are saved for at least a month. 


The commands dump and dumpdir are described in the Plexus Svs3 UNIX Programmer's 
Manual. An alternate dump schedule, which works equally well, is suggested in the 
description of the command dump in these manual pages. 


Installations with more than one logical file system must take a separate dump for each log- 
ical file system. 
Use the following procedure to take dumps: 

1. Obtain a dump tape. 


2. Ensure that all users are off the system. If mecessary, take the system to single-user 
mode (state 1) as described in the chapter, Changing [nitialization States. 


3. Insert the dump tape in the tape drive. 
4. Enter the following: 
syne ; sync 
for full dumps, enter dump Ouf /dev/rmt0 /dev/dkX 
OR 
for incremental dumps, enter dump 9uf /dev/rmt0 /dev/dkX 
where dkX is the file system being dumped. 


Wait for the dump to finish. This can take up to 30 minutes. 


an 


6. When the dump is finished, the screen displays information about the dump. Copy 
this information, preferably onto the tape label. 


If there is too much data for one tape, the system prompts the user to load a second 
tape. 


7. Remove the tape(s) and store it. 


12.2 Physical Preventive Maintenance 


This section describes the preventive maintenance that must be done to your system to keep 
it functioning correctly. It includes a list of the necessary tasks, a schedule for performing 
them, and detailed instructions for each task. These procedures are designed to be com- 
pleted without the help of service personnel. 


Perform preventive maintenance tasks at the following recommended intervals: 
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Daily — Clean tape drive components. 

Monthly — Clean or replace processor fan filters and tape drive fan filter. 
Every two years — Change clock battery. 

As required —- Dust or wash rack exterior and all front panels. 


The following sections describe each of these procedures in detail. 


12.2.1 Tape Drive Maintenance 


Perform this procedure after the first two hours of movement of a new cartridge and every 
eight hours of tape movement thereafter. During normal operation, the tape moves eight 
hours in a month. 


Using only a lint-free cotton swab moistened with isopropyl alcohol or IBM Tape Cleaner, 
clean the recording head and integral tape cleaner. 


12.2.2 Cleaning or Replacing the Fan Filter 


Once every month, clean the system filter(s). Use the applicable removal procedure as 
described in the following paragraph. 


Once the filter(s) have been removed either dry vacuum or rinse (in warm soapy water) 
and dry the filter. 


Inspect the filter after cleaning. Depending upon its condition, either reinstall the filter or 
replace it. 


12.2.3 Removal Of Fan Filters 


Filters are supplied for the two fans mounted on front of the P/35 system. Two types of 
filters and two types of mountings are used lor different systems. Older units use a single 
rectangular filter mounted directly behind the front panel of the chassis. See Figure 12-1 
for access and removal. 


Newer units use two separate filters which are mounted on the front of the front chassis 
panel immediately before each fan. ‘To determine which type of filter system your unit has, 
examine the front bottom edge of the chassis immediately below the front cover. If you can 
see two retaining mounts below the two fan positions, you have the newer filter system. 
See Figure 12-2 for fan removal on newer models. 
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Figure 12-2. Fan Removal, Newer P/35s 
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12.2.3.1 Removal of Front-Mounted Filters 
To remove front mounted filters do the following: 


1. Raise the front of unit until it is at least six inches above the mounting surface and 
block in place. 


Ine 


At the front bottom edge of chassis, grasp both mounting pins of the right filter 
mount and pull outwards. When pins release. do not pull away [rom the chassis but 
hold it in place until one hand is [ree to catch the filter. 


3. Remove the mount and catch the filter with your [ree hand. 


4. Repeat steps 2 and 3 for the left mount. 
NOTE 


A lew of the newer units were produced with a single, screw 
mounted, mounting [lange extending across the bottom edge 
of the chassis. ‘fo remove the flange, remove its two mount- 
ing screws. 


12.2.3.2 Removal of Rear-Mounted Filter 
To remove a rear-mounted filter. do the following: 
1. Remove the right side cover. 


2. ‘he filter aperture ts located at the right front corner of the chassis. The end of the 
lilter can be easily seen. A plastic tab is attached to the end of the filter. 


3. Pull the plastic tab outward; the lilter should slide easily from mounting slot. 


12.2.3.3 Replacement of Filters 


To replace either type olf filter, perform the reverse of the removal procedure. 


12.2.4 Replacing the Clock Battery 


The system clock is maintained by a 3.6-volt battery mounted to the backplane (Figure 12- 
3). Accuracy of the system clock is vital to file system integrity; each time you bring up 
your system, verify the accuracy of the system time. If discrepancies occur, reset the system 
time using the date (1) command. 


To keep the processor battery charged, run the system for at least 48 hours once every 60 
days. Should the processor battery lose its charge due to extended system shutdown, it will 
recharge once the system is up and running. Remember to reset the system clock before 


using the system. 


As a preventive maintenance procedure, the processor battery should be replaced every two 
years to ensure that it keeps the system clock current when system power is removed. 


Use the following procedure to change the clock battery: 
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{. Obtain a replacement battery (Use a General Electric Nickel-Cadmium DS 35D, 
3.6V or equivalent). 


bo 


Shut down the system as described in the chapter, “Changing Initialization States.” 


3. Remove side and top covers. To remove the P/35 side and top covers, perform the 
following sub-procedure: 


a. 


ga 


At right side of unit, remove two mounting screws located along bottom of 
cover. 


At rear of unit, remove single mounting screw from rear flange of right cover. 


Pull cover to rear until the front retaining guidepost of the cover is disengaged 
[rom its mounting hole. 


Lift cover away [rom chassis and place it in a safe storage area. 


Removal of right cover exposes retaining screws (2) along bottom edge of top 
cover. Remove these two screws if the top cover is to be removed. 


CAUTION 


Removal of the right cover exposes the entrance to the unit’s 
card cage and any cables connected to the [ront edge of the 
mounted PC boards. Care must be taken to prevent damage 
to the mounted PC boards and any exposed cables. 


At left side of unit, remove left side cover in the same manner as for the right 
side cover (i.e. steps a through d). 


Removal of left cover exposes retaining screws (2) along bottom edge of top 
cover. Remove these two screws to remove the top cover. 


To remove top cover, grasp it at both sides and lift rear of cover slightly 
upwards. Pull cover backwards to disengage locking latch located at front center 
of cover. Lilt top cover away from unit and store in a safe place. 


4. Remove mounting screws (17) from chassis top panel. Lift panel from chassis and 
store in a safe place. 
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Figure 12-3. Location of Clock Battery 
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13. 
14, 


P/35s are equipped with either a 300 or a 400 watt power supply. If you have a 300 
watt power supply, you do not need to remove it to gain access to the clock battery. 
If you have a 400 watt power supply (most likely) remove system power supply as 
described in the sub-procedure below: 


a. Remove locknut securing power supply hold-down bracket to centerbrace. 
b. Remove and store bracket. 
c. Remove screw securing power supply to front angle bracket. 


d. Remove angle bracket mounting screws (2) from left side of unit. Remove and 
store bracket. 


e. Remove mounting screws (2) securing power supply to rear mounting bar. 


f. Remove mounting screw (1) securing end of rear mounting bar to lelt side of 
chassis. 


g. Slide rear mounting bar through fitted hole in centerbrace and remove from 
unit. 


h. Standing at the left side of unit, pull power supply towards the left side of the 
chassis approximately % inch. Lift left edge of power supply upwards until unit 
is lying upside down on the disk unit. Do not disconnect any of the wires. 


Locate the battery attached to the backplane (see Figure 12-3). 
Loosen the single screw holding battery mounting bracket. 

Slide the mounting bracket to the side and olf. 

Pull the old battery straight out from backplane: discard battery. 


Install the new battery by pushing it firmly into place on the backplane. brace the 
backplane during installation. 


Reinstall battery mounting bracket. 


Reattach the power supply, reversing the steps of the power supply removal sub- 
procedure. 


Reattach the top-access plate. 


Install the chassis top and side covers. 


12.2.5 Cleaning System Exterior 


When the system’s exterior becomes soiled, clean it using Miller Stephenson Chemical Co 
MS-260, Windex, or an equivalent commercial-grade plastic cleaner. Put some cleaner on 
a soft cloth and gently wipe all soiled surfaces. 
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CAUTION 


Do not spray cleaner directly onto system and do not use 
excessive amounts of cleaner, or contamination of interior 
components may result. Moisten cloth with conservative 
amount of cleaner and wipe system gently. 
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CRISIS RECOVERY 


13.1 System Crashes 
If the power fails without warning while your Plexus system is busy, it can damage the Iile 
systems. This section describes how to recover trom this damage. 


CAUTION 


Attempting to start a damaged file system can damage it 
even more. Use the procedures in this section to protect file 
systems from further damage. 


To shut down the system gracelully when there is advance warning, use the procedures in 
the chapter, ““Changing System Initialization States.”’ 
The act of recovery after an unscheduled system shutdown includes three phases. These 
are: 

a. Restarting the system 

b. Checking and repairing damaged file systems 


c. Recovering lost data 


These three aspects of system recovery are discussed in the remaining parts of this chapter 


13.1.1 Recovering from Ungraceful Shutdowns 


After an unexpected power failure, first the power should be restored, and then the system 
should be brought up to single-user mode (init state 1) so that the tile systems can be 
checked and repaired. This process is described in the chapters, “‘Startup, Shutdown and 
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‘Tape Drive Operation” and “Changing System Initialization States.” 
CAUTION 


The system is in init state | when the single-user prompt (#) 
is displayed. Do not take the system to multi-user mode 
until the recovery is completed. 


13.1.2 Repairing File Systems 

The program for checking and repairing damaged file systems in fsck. It is described in 
detail in the Plexus Svs3 UNIX Programmer's Manual. 

Before running fsck, two precautions are advised. hese are: 


a. Create room in /lost+ found, which is a directory in root. Copy (ep) a few files into 
Nost+ found, then remove (rm) them. 


b. If there is more than one file system, verily that all file systems are listed in 
/ete/checklist. his is particularly necessary if fsck is to be used without specifying 
file systems on a multi-file system installation. (The default value for fsck with no 
parameters is the list in /ete/checklist). 

The command fsck should be run either: 


a. once with no parameters, or 


b. once for each file system, with the file system name as the only parameter. 


Yo run the command, enter either: 


fsck 
or 


fsck /dev/dkX 
where X is the disk file system number. 
The fsck program prompts for information when it finds damage. 
After fsck has completed, you may want to recover lost data before taking the system to 
multi-user mode (state 2). ‘This process is described later in this chapter. 
When ready to return the system to normal, multi-user mode, enter: 
/etc/init 2 


This results in the message: 
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#cron started 
initializing ICPs 
multi-user 
type ctrl-d 


Type control d (hold the <ctri> key and type the character d) to send login messages to 
the terminals. 


13.1.3 Recovering Lost Data 


When fsck is done, depending on the extent of damage, some files and directories may be 
missing. The fsck program reports the names of some [files it erases, but not all. To 
recover any erased files, there are two choices: 


a. Look in /lost+ found -- The fsck program puts files here when it can’t figure out 
where they belong. Copy or move files found there back to their proper locations. 


b. Recover files from backup tapes -- In the course of repairing the file systems, fsck 
removes the damaged parts. A good backup or archive system is the best insurance. 
The procedures for recovering data from dump tapes are in the next section of this 
chapter. 


13.1.4 Running restor 


The purpose for making dump tapes is to create copies of file systems on tape, to be used if 
data on the disk is lost. This can happen when the system is powered off without warning 
or when users accidentally erase data. Dump tapes are then used to recover the lost data. 


Before using dump tapes to recover data after an ungraceful shutdown, see the section 
“Recovering from Ungraceful Shutdowns.”’ In many cases, these procedures can be used to 
restore the system to its original condition, making the restor operation unnecessary. 


Restoring part or all of a system from a backup tape is controlled by the command restor. 
This command is described in detail in the Plexus Sys3 UNIX Programmer's Manual — vol 
1A. 


There are two different restore procedures: one for restoring single files or directories and 
another for restoring entire lile systems. Both are provided below. 


13.1.4.1 Restoration of Files and Directories 


Yo restore files and directories, do the following: 


1. If the data is missing because of a system failure, restore file system integrity as 
described in the section “Recovering from Ungraceful Shutdowns’’. 
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to 


Obtain the latest full dump tape and all incremental dump tapes taken since. If you 
know when the file or directory was last changed, use the incremental dump tape 
from that day. 


3. Load the full dump tape into the tape drive. 
4. Enter: 
dumpdir > temp 
This creates a file “temp” in the current directory. This file contains a list of all the 
files and directories on the dump tape with their inode numbers. 
5. Enter: 
restor x file(s) 
where "file(s)" is the name of the files (or directories) to be recovered. Use the 
entire pathname except for the name of the mounted file system. 
EXAMPLE: For the file /usr/bin/stuff, use bin/stulf. 
6. If the system responds: 


bin/stuff: inode XXXX 
Mount desired tape volume: Specify volume #: 


where XXXX is the inode number. 


Enter the tape volume number. 


NOTE 


The volume number is always 1 if the dump is only on one 
tape. If the dump is on two or more tapes (because it didn’t 
fit on one tape) load the last volume and attempt the restor. 
If a prompt complains that it can’t find the file, load the 
next volume, etc. When restor finds the file, use that volume 
number. 


7. Unload the full dump tape and store it. Load the earliest incremental dump tape in 
the tape drive. 


8. Enter: 
dumpdir >> temp 


This command adds the inode numbers from the incremental dump tape to the file 
“temp”. 


9. Enter: 
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14. 


restor x file 


exactly as above. Any files which were changed between when the full dump was 
taken and when the incremental dump was taken are updated with the new infor- 
mation. Unchanged files (from the full dump) are left unchanged. 


Repeat the above two steps with all the incremental dump tapes, working from the 
oldest to the newest. 


Look at the contents of the file “temp”. 


Look for the name of each file or directory that was restored. Write down their 
inode numbers. 


When restor restores individual files or directories, it writes them in the current 
directory using their inode numbers for file names. Use the inode numbers [rom the 
file "temp" to identify files, then use the command mv or cp to move them to their 
desired locations. 


Unload the last incremental dump tape and store it. 


If enough of a file system is damaged, it may be easier to restore the entire tile system using 
the following procedure. Use this procedure carefully; it overwrites the entire file system. 


CAUTION 


Tf the root file system is damaged, use the standalone pro- 
cedures in Chapter Eleven, “The Standalone Environment,”” 
to repair it before proceeding. 


13.1.4.2 Restoring Entire Disk Fe System 


Yo restore an entire file system. do the following: 


1. 
2. 


Obtain the latest full dump tape and all the incremental dump tapes taken since then. 


If recovering from a system crash or an ungraceful shutdown, restore file system 
integrity as described in the section “Recovering from Ungraceful Shutdowns’’. If 
recovering accidentally erased data, skip this step. 


Run the program mkfs to create a new, empty [ile system. 
Load the latest full dump tape into the tape drive. 
Enter: 

restor r /dev/dkX 


where X is the name of the newly created file system. 


EXAMPLE: /dev/dk2 


Remove the full dump tape from the tape drive and load the incremental dump tape 
taken just alter the full dump. 
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7. Enter: 


restor r /dev/dkX 
where X is the name of the [ile system used above. 


8. When the dump is finished, remove the tape [rom the tape drive and store it. 


9. Starting with the next oldest incremental dump tape, load it in the tape drive and 
repeat the last three steps. Do this with all the incremental dump tapes starting with 
the oldest and working towards the most recent. 


Since incremental dumps store only files that have changed. all files changed since the 
last full dump are progressively updated to the level of the last incremental dump. 
Files unchanged since the full dump remain unchanged. 


13.2 Trouble-Shooting Guide 


Often when a system exhibits failure symptoms, the problem is caused by a simple oversight 
such as a blown fuse, a switch in the wrong position or a cable not connected correctly. 
This section provides a checklist to help locate and correct these problems. 


For initial system-level troubleshooting, verily the following: 


Check: Reler to: 

System level: 

System power cord PLUGGED IN Installation Guide 
System Power On indicator lit Installation Guide 
System power keyswitch ON Installation Guide 
Main system fuse OK Installation Guide 


On tape drive: 


Tape heads clean Periodic System Routines” 
Tape cartridge NOT in SAFE position 
IMSP board properly seated Installation Guide 


On processor module; 
Baud rate set correctly Installation Guide 
Board properly seated 


On disk drive; 
Actuator UNLOCKED Installation Guide 
Disk-to-controller cables attached 


13.3 Recording a Core Dump 


When a hardware or software problem causes the system to stop in the system debugger, 
call Plexus Field Service so the hardware problem can be corrected or the software problem 
diagnosed. If it is not a hardware problem and there is no software solution, Plexus Field 
Service may request that you take memory and ICP dumps to send to Plexus for evaluation. 
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If your system did not crash, but one or more of your ports hung or the system is operat- 
ing improperly, follow the procedure below to provide more information: 


1. 


Have all users who had normal output from their terminals log off. Conversely, do 
not have users log off who will change the condition you are reporting. 


Record the present state of the processing environment by issuing the following com- 
mand: 


ps -efl > psefl{datetime] 
where [datetime] contains no special connectors or separators. 
Update the superblock by typing: 

syne;sync 
Continue onto the next procedure starting at step 5. 


At step 10 in the following procedure, modify the tar command to include the ps 
files you prepared in this procedure. Your tar command should look like this: 


tar -cvb 20 icpdmp* psefl* usr/ib/dnid/* etc/inittab etc/re sys3 


The following ts the procedure for preparing the dump tape when the system has 
hung up or gone into debugger mode. 


1. Write down any error messages exactly as displayed. 


2. Press the <RETURN> key and observe whether the console echoes the com- 
mand. 


3. If the error is a bus error and the system reports that it is in “SYS DEBUG” 
then type: 


r 903400 100 
and write down the last eight (8) bytes of the resulting output. 


4. {If the operating system has reported that it is in “SYS DEBUG” then type x 
and write down all registers and the PC. 


5. Dump the main memory as lollows: 
a. Procure a second person to help. 


b. Have one person press the <RESET> button while the other immedi- 
ately hits the console’s exclamation point (!) immediately alter the **P”’ of 
“PLEXUS SELFTES?T”’ appears on the console screen. 


Insert a cartridge (set not *“SAFE’’) into the tape slot. 
d. On the console keyboard, type: 
td(0,0) 
This command dumps the main memory onto the tape. 
6. Make sure your autoboot switch is olf. 


7. When the memory dump has completed (it may take awhile), bring the system 
up into single-user mode. Dump each ICP with the command: 
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/etc/icpdmp /dev/icX icpdmpX 


wherein “X”* is 0. 1, 2. or 3 for ICPs 1, 2, 3, or 4, respectively. This will per- 
form an [CP memory dump to the file icpdmpX. 


8. Position the tape to append to the memory dump without erasing it by typing: 
/usr/plx/tape srcheof 1 

9. Ensure you are in the root directory by typing: 
cd / 


10. Place the ICP dumps and other pertinent information onto the tape by entering 
the following command: 


tar -cvb 20 icpdmp* usr/lib/dnid/* etc/inittab etc/re sys3 


11. ‘Yo aid Plexus Field Service write down the revision level of each printed circuit 
board in your system’s card cage. To do so, follow this sequence: 


a. Shutdown the system completely (1.e., turn it off). 
b. Expose the card cage. 


c. Remove any cables that obstruct the boards from removal, taking care to 
note the connect points for reconnection. 


d. Using the built-in ejectors, slide each board far enough out of the cage to 
enable reading and recording the serial numbers, revision levels, and 
manufacturing lots of each board in the cage. 


e. Re-insert the boards, ensuring that the edge connectors are firmly seated 
in the backplane sockets. 


f. Reconnect any cables that you disconnected in step C, above. 
12. Write a short description of the problem you encountered, including: 

e What programs were running at the time. 

@ What devices were attached to the ICP (e.g., CRTs. printers). 


e Any unusual circumstances such as high number of processes, power fluc- 
tuations, strange system behavior before the error messages appeared or the 
crash occurred. 


Your description is important for Plexus Field Service to quickly identify the 
nature of the problem. 
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Overview 


When you turn on or reset a Plexus system, the boot PROMs instruct the main processor to 
test itself, its memory, and the other processor boards — the ICP (Intelligent Communica- 
tions Processor for controlling serial and parallel ports and the IMSP (Intelligent Mass 
Storage Processor for controlling disk and tape drives). If any of the components on these 
processor boards fails the initial self-test, the system writes error codes to the console and/or 
causes certain LEDs (Light-Emitting Diodes) on the board in question to light or flash to 
signal the problem. If the system encounters a hardware error it prevents the system from 
booting up. This protects your software from being inadvertently destroyed by component 
failures. 


The self test sequence consists of two phases within each of the processor boards tested, 
phase 0 and phase 1. Phase 0 is a short basic test that ensures that the particular board is 
stable enough to attempt to run the more sophisticated tests of phase 1. Phase I tests are 
more thorough; they check out each component on each board before returning the 
PLEXUS SELFTEST COMPLETE message. 


If any aspect of the system fails selftest, the system tries to print a message to the console. 
It also lights a pattern of LEDs on the faulty board to help indicate the problem. 


This appendix gives the test names, test numbers, and error numbers that a user might 
encounter during selftest. The numbering scheme for error numbers also indicates what 
kind of processor board has had a failure: 


Error numbers Ox! through Oxff (hex) are reserved for the CPU, also known as the main 
processor board. Error numbers 0x101-Oxiff indicate an ICP error; error numbers Ox201- 
Ox2ff indicate an IMSP error. 


Lists of ICP error messages and codes occur later in this appendix. The equivalent lists of 
IMSP failures will be supplied in a future version of this document. 


The system also uses LEDs on the processor boards themselves to indicate the status and 
progress of the selftest. While the selftest is in progress, the LEDs light in patterns 
representing binary codes that indicate which individual test within selftest is currently 
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underway. This appendix also shows what these LED codes indicate. Reading the LEDs 
requires that you are able to see the front edges of the processor boards as they rest in the 
card cage. This introduction includes a procedure [or gaining access to the card cage. 


This appendix is provided for reference only. Plexus does not necessarily require end-user 
customers to involve themselves with the computers at the hardware/lirmware interlace 
level. We provide the diagnostic codes here, however, to aid customers when talking to 
field service if your system returns a diagnostic message during selftest. Having this infor- 
mation in hand can speed up communication with Plexus Field Service and shorten the 
time to repair the system when your field service representative arrives at your installation 
site. 


Accessing the Card Cage 

If you intend to look at the diagnostic LEDs or set any switches on the processor boards 
themselves, you must be able to gain access to the system card cage. To access the card 
cage of a P/35 and/or remove any cards {rom the card cage, follow the procedure immedi- 
ately below: 


1. At the right side of unit as you face the front, remove the two mounting screws 
located along the bottom of the cover. 


WN 


At the rear of the unit, remove the single mounting screw from the rear flange of the 
right cover. 


3. Pull the cover toward the rear until the front retaining guidepost of the cover is disen- 
gaged from its mounting hole. 


4. Lift the cover away [rom its chassis and place it in a sale storage area. 
CAUTION 


Removal of the right cover exposes the entrance to the unit’s 
card cage and any cables connected to the [ront edge of the 
mounted PC (printed circuit) boards. Care must be taken to 
prevent damage to the mounted PC boards and any exposed 
cables. 


5. You now have the card cage exposed. Diagnostic LEDs lor each of the boards face 
outward toward you. They are mounted near the edges of the boards closest to you. 
The 8-position DIP switch on the CPU is also on the front edge of that card. You 
probably need not extract this board to change or check switch settings. 


NOTE 


If you need to remove any of the PC boards to set switches 
or jumpers, follow the rest of the procedure as it continues 
below. If vou want to simply examine the LEDs for diagnos- 
tic purposes, stop at this point. 
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6. Remove the PC board retaining bracket. It is a metal brace centered in front of the 
card cage opening. 


7. Remove the I/O cable(s) from the PC board you wish to remove. To remove an I/O 
cable, pull the locking levers at either end of the card-mounted cable jack outward to 
release the cable connector. Then, disengage the cable connector. 


8. ‘To remove a PC board, pull the card ejector levers at each corner of the board, 
simultaneously, towards you. This disengages the board from the cage connector. 


9. Pull the board straight out. Do NOT bend or flex the board in any way while remov- 
ing it from the cage. 


10. You may have to remove (and later reconnect) additional cables. 
NOTE 


Cables and mating connectors are marked to prevent 
incorrect pin connections. On all Plexus cables, pin 1 is 
indicated by a triangle on the cable connectors. Most Plexus 
cables also indicate pin | by a red stripe at the pin | edge of 
the cable. Match this stripe to pin 1 of the header. 


11. ‘To re-insert the PC board, reverse the above steps. 


Card Cage Slot Assignments 


The card cage PC board slot assignments are shown in the following diagram: 


Plexus Computers Page A-3 


Diagnostics P/60 User’s Manual 


Slot # Board Assignment 
| pa eee ee ee ee eee + | 
| 1 | | | Memory 
| ec + | 
| 2 | | | Second memory * 
| fen eee eee ee ee ee ee ee ee ee ee ee eee eee eee + | 
| 3 | === | | Processor 
| pee ee ee ee eee ee ee eee ee eee ee eee eee + | 
} 4 J=== oe ee | | Second I[CP* 
| fen ne ee eee ee eee + | 
a | | ICP 
| fee eee eee ee eee ee ee ee eee + | 
es | | ITMSP 
| fee eee ee eee ee ee eee ee eee eee ee eee + | 
* Second memory and second ICP are optional. The dots (....) represent the position 


of front edge (J) connectors. 


=== This symbol represents the approximate location of the status LEDs on the CPU and 
ICP. The specific location of the LEDs can vary somewhat. ICP LEDs may be in 
front of, alongside, or behind the metal brace that runs the length of that processor 
board. 


68000-based CPU Diagnostics 


The CPU performs two levels of selftest, phase 0 and phase t. In phase 0, the system 
checks the PROM checksums, tests the cache data, the memory map, and the cache dirty 
bit and page clear functions. Phase 0 is executed {rom assembler code, and corresponds to 
the the PLEX part of PLEXUS SELFTEST X.X message that appears on the con- 
sole screen when you turn the system on or press the reset button. Under ordinary cir- 
cumstances, if the system fails phase Q of selftest, the selftest ends at that point, the console 
displays an error message, and the CPU’s LEDs display a binary representation of the error 
encountered. The other function of phase 0 is to ensure that the hardware environment can 
execute phase 1 from C code. 


In phase 1, the CPU perltorms 16 more tests from the C language; two of these tests are 
more thorough versions of phase 0 tests. Phase 1 corresponds to the display of US 
SELFTEST X.X portion of the PLEXUS SELFTEST X.X console display on 
power-up or reset. Unlike phase 0, phase | selftest does not halt at the first error encoun- 
tered; it continues as long as the hardware permits. If phase 1 encounters failing com- 
ponents, selftest outputs the test name, test number, and failure number (error code) to the 
console. 


In addition, the CPU board has 8 LEDs. LEDs () through 3 display in binary the current 
test in progress. If there are any lailed tests, LEDs 4 through 7 display the binary represen- 
tation of the number of the most recently failed test. 
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Hardware Dependencies 


For the information in this appendix to be useful, certain characteristics of the main proces- 
sor board must be present. The diagnostic/boot PROM set must be at a minimum revision 
level shown below. Further, the CPU has an 8-position DIP (Dual In-line Processor) switch 
near the front edge of the board. The settings of the switch determine several lactors 
regarding the behavior of the console port and must be set to a workable pattern to estab- 
lish a system/user interlace. 


PROM Dependencies 
For the MC68000-based processor board (CPU), the boot/diagnostic PROM set must be the 
following Plexus part numbers and checksums: 


Part Number Checksum (Hex) 


66-00207-2 6F4A 
66-00208-2 Bé600 


Switches and LEDs 


The main processor board contains an 8-position DIP switch, a bank of eight small red 
LEDs, and five larger LEDs located in a row along the [front edge of the board as you lace 
it in the card cage. In this section we are concerned only with the DIP switch and the bank 
of eight small red LEDs. 


The DIP switch sets the console baud rate, enables or disables Autoboot mode, selects 
which console port is active, and enables or disables the diagnostic mode. 


CAUTION 
Diagnostic mode is NOT recommended for anyone but 
Plexus-trained field engineers. Use of diagnostic mode by 
untrained users could result in further damage to your sys- 


tem. 


The settings of each of the eight switches on the DIP switch are as shown in Figure A-1. 
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SWwo0 See baud 
Set Baud Rate Swi rate 

SW2 _ settings, below. 

Enable Disable 

Auto Boot Mode { SW3 ON OFF 
Console Port P3 { Sw4 ON OFF 
Console Port P4 { SW5 ON OFF 
(unused) { SW6 
Diag. Monitor { SW7 ON OFF 


Figure A-1. Switch S1 Configuration 


Switch 7 enables diagnostic mode which should be turned on and used only by trained 
Plexus personnel. Switch 6 is not used. Switches 5 and 4 enable console ports P3 and P4 
respectively. To enable both ports, set both switches to OFF. Turning switch 3 ON enables 
Autoboot mode. Switches 0 through 2 set baud rates 110 through 19200 via the ON/OFF 
combinations shown in the table below. The Plexus default is 9600 baud. The Plexus fac- 
tory setting for all switch positions ts: 


Switch Number: 7 6 5 4 3 2 1 0 
Plexus Setting: OFF OFF OFF ON OFF ON ON) OFF 


Switch: 2 l 0 Baud Rate 
OFF OFF OFF 110 
OFF OFF ON 300 
OFF ON — OFF 600 
OFF ON ON 1200 
ON OFF OFF 2400 
ON OFF ON 4800 
ON ON OFF 9600 
ON ON ON 19200 


The bank of eight LEDs provides binary patterns to represent the test numbers failed 
and/or of test numbers in progress. The LED error reporting scheme tor phase 0 is some- 
what different than that for phase 1. In phase 0, all eight LEDs may be used to report a 
single error. In phase |, LEDs 0 through 3 report the test number in progress while LEDs 4 
through 7 indicate the test number ol the most recently failed test. 


Self-Test Sequence 
The console prints the following messages upon power up or reset: 


< line feed > 

< carriage return > 

PLEXUS SELFTEST REV X.X COMPLETE 

< line feed > 

< carriage return > 

SYSTEM CONFIGURATION: fim} fis} {rm} fex} {icO..ic4} xxxx Mb 
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Within the initial selftest message, certain letters or combinations represent successful com- 
pletion of progressive steps in the self-test routine. ‘The console displays the PLEX of 
PLEXUS lirst during phase 0 and then US SELFTEST REV X.X during phase 1. 
There will not be a significant time delay between the two messages output (that is visible 
to the user). The P is printed after the PROM checksum, the L is printed after the cache 
data test, the E ts printed alter the map test and the X is printed after the cache dirty bit 
and page clear test. If any errors are encountered during phase 0, the readout halts without 
printing US SELFTEST REV X.X, which is printed alter successful completion of 
phase 0 and a C environment is created. 


COMPLETE is printed only if the complete (phase 0 and phase I) selltest passes. If the 
sel{test fails then the message SELFTEST FAILED is printed on the line following the 
last error message. 


For completed selftests, the other controller boards represented by the mnemonics within 
brackets ({ }) are output if the devices they drive are determined to be present in the sys- 
tem. Driver codes represent the following system components. 


pd - IMSP disk controller 

xy - Xylogics disk controller 

pt - IMSP tape controller 

rm - Tapemaster tape controller 
ex - Excelan Ethernet controller 
icQ-ic4 - ICP comm controller 0-4 


xxxx Mb - memory size 


A failure of one of the four initial tests (1.2.4, or 8: P, L, E, or X) causes the 
sel{test to stop (provided that switch 7 of the CPU board is off) since the system is not 
functioning sulficiently to proceed with the selftest. It flashes the [ailing test number in the 
bank of LEDs on the processor board. All failing subtests detected are displayed on the 
system console with a brief error description. All failing subtests detected are also sequen- 
tially displayed in the LEDs 0-3 until you enter a <del> (go to monitor proper) or ! (go 
to PROM). The diagnostic monitor commands can be used to get a more detailed explana- 
tion of the failure but are intended lor use by trained Plexus Technical Staff. 


The LEDs brielly flash at the start of the program to verify their functionality. Then the 
positions of the DIP switch are displayed in the LEDs. The test number (see test descrip- 
tion) is displayed in the LEDs 0-3 during program execution and the last failing test is 
displayed in LEDs 4-7. 


The following is the order of the selftests, their names, and test numbers. Descriptions of 
the each of the tests occur after that. The phase zero tests (tests 4 & 8) contain a limited 
version of the corresponding Phase | tests (tests 4 & 8) just to ensure that a sufficient 
amount of the board is functional to execute C code. The phase zero tests are listed first 
followed by the rest of the tests. 
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TABLE A-1. Test Number List 


Test# 


OpNHK 


= 


Co WOmrTD NN WN 


—-—o7onnangs 


Phase 0 Tests 


Letter 


“naxx mrs 


=“nAMH DMA 


Test Name 


LED and switch test 

PROM checksum 

Cache data (limited test) 

Map tests (limited test) 

Cache page and dirty bits cleared 


Phase I Tests 


Test Name 


LED and SWITCH test 
PROM CHECKSUM test 
CACHE DATA test 

EPCT test 

MAP test 

CLOCK MEM test 

CLOCK INT test 

SCRATCH RAM test 
CACHE DIRTY BIT and PAGE test 
REGISTER test 

MAP ID and PRIVILEGE test 
MAIN MEMORY test 
MAPPER test 

ECC test 

WRITE protect test 
PROCESSOR errors 
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TABLE A-2. Test Descriptions 


Test descriptions: 


Test # Test 

(hex) Name 

ff LED 

l PROM CHECKSUM 
2 CACHE DATA 
3 EPCI 

4 MAP 

5 CLOCK MEM 
6 CLOCK INT 

7 SCRATCH RAM 
8 CACHE DIRTY 
9 REGISTER 


Plexus Computers 


Description 
Lights all LEDs and then copies switches into LEDs. 


Does a word sum on each pair of PROMs. Expects 
the sum to be zero. 


Does standard memory test (ones,zeros,address, slid- 
ing bit,byte) to cache data bits. After completion of 
test, stack is put in high cache. 


Each EPCT is tested in the data loopback mode with 
a march and sliding bit pattern. The EPCTs are rein- 
itialized before any error messages are printed out 
then initialized to continue the test. 


The map is tested with 0’s,l’s,address,sliding bit, 
byte. 


The test saves the memory and registers for restora- 
tion alter the test is complete. The memory is tested 
with 0’s,1’s,address,sliding bit. 


The clock chip ts initialized to interrupt the CPU. If 
the CPU can recognize the interrupt then the test 
passes. 


The scratch RAM its tested with 0’s. 1’s, address and 
sliding bit. 


The cache dirty bit and page numbers are tested with 
0’s, 1’s, address and sliding bit. 


Reads/writes registers, reads read only register and 


compares to expected value, writes write only register 
if effect can be seen in another register. 
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a MAP ID & PRIV The [functionality of the id register and the privilege 
bits are tested. The scratch RAM its used for this 
testing(write protect uses main memory also). A spe- 
cial bus error routine is added to allow lor these 
tests. A pattern is written to the RAM. Two pages 
are read protected and then they are read and 
summed. Then a subroutine is loaded into scratch 
and execute protected. The subroutine is executed. 
If the first instruction does not generate an error an 
error flag is loaded and then jumps out of the scratch 
RAM. The id register 1s loaded. The processor is put 
into user mode and then tries to read scratch RAM. 
A trap call puts the processor back into system mode 
if the test fails. 


b MAIN MEMORY The size of main memory is checked and the 
memory is tested with address, inverted address and 
sliding bit. 

c MAPPER All map entries point to same page. A location in 


each virtual page is incremented (same physical loca- 
tion). Walue is compared to expected. If no memory 
then only mapping to scratch memory is tested. 


d ECC TEST The ECC chip is tested in diagnostic mode and also 
single and double bit errors are forced. Syndromes 
from single bit errors are compared to expected 
values. [{ no memory boards are present then test is 
skipped. 


e WRITE PROTECT — Scratch RAM and main memory are written with a 
pattern. Some pages are write protected. memory is 
then cleared. The memory is checked to see if zeros 
were written to non write protected pages and the 
pattern remains tn the write protected memory. If no 
memory then test is skipped. 


f PROCESSOR The processor boards (IMSP and ICP) writes the 
results of their selftests into 68k memory. The 
failures tf any are output. (See the appropriate func- 
tional specification for specilic error information for 
the ICP and IMSP cards.) 


Error Codes and Messages 


If the CPU encounters an error during selltest, it attempts to create an error message and 
write it to the console. The syntax of these error messages differs between phase 0) and 
phase 1. Within both phases of error messages, however, is an error code, a hexadecimal 
number, that represents what part of the self-test lailed. In certain cases, component failure 
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may prevent the error message [rom appearing on the console screen. In such case the pro- 
cessor board is still able to indicate the number of the test that failed via its bank of eight 
LEDs. 


The syntax of phase O error messages is: 
<testname><error code><address><data received><data expected > 
The syntax of phase 1 error messages is: 


<testname> <test number>F ATLED <error code> 


The following are the potential range of errors in the initial phase 0 tests. The board’s 
LEDs display one of the lollowing codes in the event of a phase 0 error. 


TABLE A-3. Phase 0 LED Display Codes 


LED Hex Value Failure 
onooooe 01 PROM checksum was incorrect 
coOnMnee 02 Cache data failed memory test 
oononeds 04 Map failed memory test 
oooneno 08 Cache page and dirty bits cannot be cleared 
oofecooo 10 EPCI A was selected and timed out 
opeqooo 20 EPCI B was selected and timed out 
cennnnad 40 Data written to cache could not be read [rom 

virtual 0 


If the board is not in diagnostic mode, the LEDs flash the error code value. If the board ts 
in diagnostic mode, the LEDs provide a constant display of the error code. 


An error message can also be output to the console. Phase 0 error messages are of the 
form 


<testname> <error number> <address> <data received> <data expected> 


If any of the fields are not necessary they are output null. he <error number> is found in 
Table A-4. Only the PROM checksum, the cache data memory test, map memory test, and 
cache page test output error messages. The two EPCT tests and the virtual 0 read test will 
not output error messages. (If there is a fault in the EPCI hardware area, the error mes- 
sages from the first four tests may also not come out.) 


TABLE A-4. Phase 0 Error Message Numbers 


Error 
Number — Description 


Checksum of diagnostic PROMs was not 0. 
Checksum of boot PROMs was not 0. 
Cache data failed address test 

Cache data failed sliding bit test 


Nm eo 
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7 Cache data failed inverted address test 

a Map failed address test 

b Map failed sliding bit test 

c Map failed inverted address 

d Cache dirty bit and page could not be cleared 


Phase 0 Error Messages 


The failure messages of phase 0 tests differ from those of phase | since failure information 
is output before the test is halted. The test message gives an error code also that vou can 
also look up on the error code list to get additional information about the failure. The [ol- 
lowing lailure messages can be output during the phase 0 tests. 


Error 
Message Meaning 


PROM [lor2]| PROM failed checksum test. If the test number is |, the 
monitor PROMs failed: if the test number is 2 then boot 
PROMS Iailed. 
NOTE 


If the board has been set for 32K PROMs the proper lights 
will be set but the error message could be incomplete (since 
the processor cannot access all of the code). 


Error 
Message Meaning 


DATA [5-7] x yz | Cache data RAM failed test 5, 6, or 7 at address x when it 
read value y which should have been z. 


MAP [a-c] k yz MAP RAM failed test a, b, or ¢ at address x when it read 
value y which should have been z. 


PAGE d xy 0 Cache page and dirty bits failed test d at address x when it 
read y which should have been 0. 


Phase 1 Error Codes 


The following are the errors in the tests performed by phase 1 of selltest. Phase 1 error 
messages are Output to the console in the form: 


<test name> <test number> FAILED <error number> 


If any of the fields are not necessary they are output null. The <error number> is found in 
Table A-S. 
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Error 
Number 
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TABLE A-5. Phase 1 Error Codes 


Description 


Checksum of diagnostic PROMs was not 0. 
Checksum of boot PROMs was not 0. 
Cache data failed 1’s test 

Cache data lailed 0’s test 

Cache data failed address test 

Cache data failed sliding bit test 

Cache data failed inverted address test 
Map failed 1’s test 

Map lailed 0’s test 

Map failed address test 

Map failed sliding bit test 

Map failed inverted address 

Cache dirty bit and page could not be cleared 
EPCT A failed loopback address test 


EPCT A timed out during loopback address test 


EPCI B failed loopback address test 


EPCI B timed out during loopback address test 


Clock’s calendar RAM failed 1’s test 

Clock’s calendar RAM failed 0s test 

Clock’s calendar RAM failed address test 
Clock’s calendar RAM failed sliding bit test 
Clock’s nonvolatile RAM failed 1’s test 
Clock’s nonvolatile RAM failed 0’s test 
Clock’s nonvolatile RAM l[ailed address test 
Clock’s nonvolatile RAM failed sliding bit test 
clock interrupt test received improper number 
of interrupts 

ID register failed sliding bit test 

Scratch RAM failed 1’s test 

Scratch RAM failed 0’s test 

Scratch RAM failed address test 

Scratch RAM failed sliding bit test 

Scratch RAM failed byte test 

Cache dirty bit and page failed 1’s test 

Cache dirty bit and page [ailed 0’s test 

Cache dirty bit and page lailed address test 
Cache dirty bit and page failed sliding bit test 
Read protect test failed 

Execute protect test failed 

ID privilege test failed 

User in system space (user with a23 = 1) 
Main mem failed address test 

Main mem failed inverted address test 

Main mem failed sliding bit test 


Diagnostics 
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Improper amount of memory or no memory 
Single bit error 

Mapper func. test couldn’t map into main memory 
Mapper func. test couldn’t map into scratch RAM 
Memory board did not correct the forced sbe 
CPU did not receive expected sbe interrupt 
Incorrect syndrome was received for forced error 
Expected double bit error; bus error not received 
Memory write protect did not function properly 
Received different bus error than was expecting 
Status register incorrect after buserror 

Memory error register incorrect in ecc test 
Memory error address incorrect in ecc test 

Unable to unlock multibus 

Unable to lock multibus 

Failed cache byte test 

PROMS set lor 128k instead of 64k 


The diagnostic tests cannot recover {rom the following errors and will immediately print an 
error message and end the test except lor 93 (single bit interrupt). 


70 
7) 
72 
73 
74 
75 
76 
77 
83 
90) 
93 
95 
96 
98 
al 
a2 
a3 
a9 
bO 
b3 
b4 
b6 
ba 
bd 


Received multibus interrupt 0) 
Received multibus interrupt | 
Received multibus interrupt 2 
Received multibus interrupt 3 
Received multibus interrupt 4 
Received multibus interrupt 5 
Received multibus interrupt 6 
Received multibus interrupt 7 
Received clock interrupt 
Received powerfail interrupt 
Received single bit or dma error interrupt 
USART a interrupt 

USART b interrupt 

Tegal interrupt 

Address exception 

Buserror exception 

Chkinst exception 

Tegal instruction 

CPU privilege exception 
Spurious interrupt 

‘Trapv instruction 

‘Trace exception 

Zero divide 

Zero divide 


Phase I Error Messages 


The remainder of the tests will have error messages printed out in the following format: 


Page A-14 


Plexus Computers 


P/60 User’s Manual Diagnostics 


<test name>(t<test number>) FAILED (<lailure number>) 


NOTE 


If a problem causes the processor to get lost the test listed 
will be the last test executed. This will most likely occur in 
the last test since if an error occurs during the boot process 
the last test will be listed. 


The exception to this is the message printed for failing 
boards in the system which is of the format: 


<driver name> FAILED (<failure number>) 


ICP Card Diagnostics 


The ICP is the circuit board that controls interaction between the system and serial and 
parallel I/O devices such as printers, terminals, and modems. The diagnostics built into the 
ICP can function in one of two ways: I[t can communicate certain messages to the main 
processor and subsequently to the system console, or it can offer more detailed diagnostics 
in a standalone mode wherein a terminal becomes a dedicated console by connecting it to 
the ICP’s tty0 port. 


This section, being oriented toward the end-user, contains diagnostic information relative to 
system interface diagnostics only. The ICP’s standalone diagnostics are reserved for 
Plexus-trained field service personnel. 


Even in system interface mode, however, the ICP generates some diagnostic codes during 
selftest in the form of LED patterns on the ICP itself. ‘This appendix supplies the meanings 
of those LED patterns as well. 


Hardware Dependencies 


For the diagnostic information in this appendix to be correct, the ICP PROMs and 8- 
position DIP switch (not to be confused with the CPU’s PROMs and DIP switch) must con- 
form to the information contained below: 


PROM Dependencies 


For the Intelligent Communications Processor board (ICP), the diagnostic PROM set must 
be the following Plexus part numbers and checksums, or later versions of the part numbers. 


Part Number Checksum (Hex) 


66-V0110-1 (4BF4) 
66-V01 11-1 (0C00) 
66-00112-1 (1FB1) 
66-00113-1 (4F00) 
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Switches and LEDs 


The ICP has a bank of four small red LEDs that are located somewhere in the vicinity of 
the front felt corner of the board as you lace the front of the card cage. ICP LEDs may be 
in front of, alongside, or behind the metal brace that runs the length of that processor 
board. 


The ICP also has an 8-position DIP switch whose settings may affect the transmission of 
diagnostics to the host processor’s console. You must extract the ICP board [rom the card 
cage to check or set the DIP switch. ‘The switch settings are as follows: 


Function ON OFF 

Memory Save SWO0 Save memory Perform destructive 
contents memory test 

Diagnostic Reporting SWI Report errors Standalone 
to CPU 

External Clock 0) SW2* Connect synchronous Disabled 
modem to tty 0O—3 

External Clock | SW3* Connect synchronous Disabled 
modem to tty 4—7 

(unused) SWw4 

(unused) SW5 

(unused) SW6 

(unused) SW7 


* The settings for switches 2 and 3 depend on what sorts of devices are connected to this 
particular [CP. If you connect a synchronous modem (i.e.. one with its own clock) to the 
ICP’s tty port 0, 1, 2. or 3, you must set switch 2 to ON. If you connect a synchronous 
modem to the [CP’s tty port 4, 5, 6, or 7, you must set switch 3 to ON. If either of these 
switches are set incorrectly relative to your board’s I/O configuration, your entire system 
will not boot properly. 


ICP Error Numbers and Meanings 


The following error codes and brief descriptions correspond to the syntax of phase | board 
failures as described in the CPU section of this appendix: 


<driver name> FAILED <error code> 


For example, if ICP 0 failed the sliding bit test, the message written to the system console 
would be: 


icpO FAILED 107 


The [CP error numbers and their meanings are as follows: 
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Number — Test 


101 
102 
103 
104 


105 
106 


107 


108 
109 
10a 
!0b 
10c 
10d 
10e 
107 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
lla 
lib 
lle 
lld 
lle 
lif 
120 
121 
122 
123 
124 
125 
126 
127 


128 
129 
12a 


Plexus Computers 


— 


Amn 


ICP Error List 
Meaning 


diagnostic PROM had incorrect checksum 
system PROM had incorrect checksum 


read illegal wakeup address (board not set for icp0 or 1) 


inconsistent read of wakeup address 


failed word address test 
failed byte address test 


failed sliding bit test 


ctcO channel 0 could not write/read time constant 
ctc0 channel | could not write/read time constant 
ctcO channel 2 could not write/read time constant 
ctcO channei 3 could not write/read time constant 
ctc! channel 0 could not write/read time constant 
ctcl channel | could not write/read time constant 
ctcl channel 2 could not write/read time constant 
ctcl channel 3 could not write/read time constant 
ctc2 channel 0 could not write/read time constant 
ctc2 channel | could not write/read time constant 
ctc2 channel 2 could not write/read time constant 
ctc2 channel 3 could not write/read time constant 
ctc3 channel 0 could not write/read time constant 
ctc3 channel 1 could not write/read time constant 
ctc3 channel 2 could not write/read time constant 
ctc3 channel 3 could not write/read time constant 
ctcO0 channel 0 decremented incorrectly 
ctcQ channel | decremented incorrectly 
ctcO channel 2 decremented incorrectly 
ctcO channel 3 decremented incorrectly 
ctcl channel () decremented incorrectly 
ctcl channel 1 decremented incorrectly 
ctcl channel 2 decremented incorrectly 
ctc! channel 3 decremented incorrectly 
ctc2 channel 0 decremented incorrectly 
ctc2 channel | decremented incorrectly 
ctc2 channel 2 decremented incorrectly 
ctc2 channel 3 decremented incorrectly 
ctc3 channel 0 decremented incorrectly 
ctc3 channel | decremented incorrectly 
ctc3 channel 2 decremented incorrectly 
ctc3 channel 3 decremented incorrectly 


ctc() channel 0 incorrect number of interrupts generated 
ctcO channel | incorrect number of interrupts generated 
ctcQ channel 2 incorrect number of interrupts generated 


Diagnostics 
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12b 
12c 
12d 
12e 
121 
130 
131 
132 
133 
134 
135 
136 
137 


138 
139 
I3a 
13b 


[3c 
13d 
l3e 
13f 
140 
141 
142 
143 
ldc 
14d 
14e 
14f 
150 
151 
152 
153 


154 
155 
156 
157 
158 
159 
15a 
15b 
15¢ 
15d 
15e 
15f 
160 
16] 
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etc) channel 3 incorrect number of interrupts generated 
ctcl channel 0 incorrect number of interrupts generated 
ctcl channel | incorrect number of interrupts generated 
ctcl channel 2 incorrect number of interrupts generated 
ctcl channel 3 incorrect number of interrupts generated 
ctc2 channel O incorrect number of interrupts generated 
ctc2 channel | incorrect number of interrupts generated 
cte2 channel 2 incorrect number of interrupts generated 
ctc2 channel 3 incorrect number of interrupts generated 
ctc3 channel O incorrect number of interrupts generated 
ctc3 channel | incorrect number of interrupts generated 
ctc3 channel 2 incorrect number of interrupts generated 
ctc3 channel 3 incorrect number of interrupts generated 


sio 0 improper write/read of interrupt register 
sio | improper write/read of interrupt register 
sio 2 improper write/read of interrupt register 
sio 3 improper write/read of interrupt register 


sio0 channel A did not generate single interrupt 
sio0 channel B did not generate single interrupt 
siol channel A did not generate single interrupt 
siol| channel B did not generate single interrupt 
sio2 channel A did not generate single interrupt 
sio2 channel B did not generate single interrupt 
sio3 channel A did not generate single interrupt 
sio3 channel B did not generate single interrupt 
sio0 channel A received incorrect character on loopback 
sio0 channel B received incorrect character on loopback 
siol channel A received incorrect character on loopback 
siol channel B received incorrect character on loopback 
sio2 channel A received incorrect character on loopback 
sio2 channel B received incorrect character on loopback 
si03 channel A received incorrect character on loopback 
sio3 channel B received incorrect character on loopback 


sio0 channel A test did not generate ctc interrupt 
sio0 channel B test did not generate ctc interrupt 
siol channel A test did not generate ctc interrupt 
siol channel B test did not generate ctc interrupt 
sio2 channel A test did not generate ctc interrupt 
sio2 channel B test did not generate ctc interrupt 
sio3 channel A test did not generate cte interrupt 
sio3 channel B test did not generate ctc interrupt 
sio0 channel A dma count register did not count down properly 
sio0 channel B dma count register did not count down properly 
siol channel A dma count register did not count down properly 
siol channel B dma count register did not count down properly 
sio2 channel A dma count register did not count down properly 
sio2 channel B dma count register did not count down properly 
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162 
163 
164 
165 
166 
167 
168 
169 
16a 
16b 
l6c 
16d 
l6e 
16f 
160 
161 
162 
163 


174 


175 
176 
177 
178 
179 
l7a 
17b 
l7c 
17d 
17e 
17f 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
18a 
18b 
18c 


18d 
[8e 


18f 


10 OREO CHRO CHRO OREO CHAO CEO OREO CHRO CHRO OREO CHRO CHEO CHRO OREO ¢) 


awe aH 


Na) 


b 
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sio3 channel A dma count register did not count down properly 
sio3 channel B dma count register did not count down properly 


sio0 channel A did not receive character 
sio0 channel B did not receive character 
siol channel A did not receive character 
siol channel B did not receive character 
sio2 channel A did not receive character 
sio2 channel B did not receive character 
sio3 channel A did not receive character 
sio3 channel B did not receive character 
sio0 channel A received incorrect character 
sio0 channel B received incorrect character 
siol channel A received incorrect character 
siol channel B received incorrect character 
sio2 channel A recetved incorrect character 
sio2 channel B received incorrect character 
sio3 channel A received incorrect character 
sio3 channel B received incorrect character 


pio loopback received incorrect data 


dmaO channel 0) low address reg failed write/read 
dmaQ channel | low address reg failed write/read 
dma0Q channel 2 low address reg failed write/read 
dma0 channel 3 low address reg failed write/read 
dmal channel 0 low address reg failed write/read 
dmal channel 1 low address reg failed write/read 
dmal channel 2 low address reg failed write/read 
dmal channel 3 low address reg failed write/read 
dma2 channel 0 low address reg failed write/read 
dma2 channel 1 low address reg [ailed write/read 
dma2 channel 2 low address reg failed write/read 
dma2 channel 3 low address reg failed write/read 
dma0 channel 0 high address reg failed write/read 
dma0 channel 1 high address reg failed write/read 
dma0 channel 2 high address reg failed write/read 
dma0 channel 3 high address reg failed write/read 
dmal channel 0 high address reg failed write/read 
dmal channel 1 high address reg failed write/read 
dmal channel 2 high address reg failed write/read 
dmal channel 3 high address reg failed write/read 
dma2 channel 0 high address reg failed write/read 
dma2 channel 1 high address reg failed write/read 
dma2 channel 2 high address reg failed write/read 
dma2 channel 3 high address reg [failed write/read 


improper number of ctc interrupts 
dma word count not Oxll 


sio0 channel A improper number of ctc interrupts 
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190 b 
191 c 
192 c 
193 d 
194 d 
195 e 
196 e 
197 b 
198 b 
199 c 
19a c 
19b d 
19¢c d 
19d e€ 
19e e 
la0 10 
lal 10 
la2 10 
la3 10 
lad 10 
la7 12 
1a8 2 
la9 8 
laa 8 
lab 8 
lac 8 
lad 8 
lae 8 
laf 8 
1b0 8 
1b5 2 
1b6 2 
1b7 3 
1b8 13 
1b9 15 
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sio) channel B improper number of ctc interrupts 


siol channel A improper number of ctc interrupts 
siol channel B improper number of ctc interrupts 


sio2 channel A improper number of ctc interrupts 
sio2 channel B improper number of ctc interrupts 


sio3 channel A improper number of ctc interrupts 
sio3 channel B improper number of ctc interrupts 


sio) channel A dma address register not Oxtf 
sio0 channel B dma address register not Oxf 


siol channel A dma address register not Oxtf 
siol channel B dma address register not Oxf 


sio2 channel A dma address register not Oxi 
sio2 channel B dma address register not Oxtf 


sio3 channel A dma address register not Oxf 
sio3 channel B dma address register not Oxif 


dma sio 0/1 latch test sio timeout 

dma sio 2/3 latch test sio timeout 

dma sio 0/1 latch test incorrect data read 
dma sio 2/3 latch test incorrect data read 
dma pio latch test failed 


multibus address test of main processor memory failed 
multibus sliding bit test of main processor memory failed 


sio0 channel A generated incorrect number of interrupts 
sio0 channel B generated incorrect number of interrupts 
siol channel A generated incorrect number of interrupts 
siol channel B generated incorrect number of interrupts 
slo2 channel A generated incorrect number of interrupts 
sio2 channel B generated incorrect number of interrupts 
sio3 channel A generated incorrect number of interrupts 
sio3 channel B generated incorrect number of interrupts 


parity error address test (integer) 
parity error address test (byte) 


parity error sliding bit test 
parity error not received 


character not received on pio dma loopback 
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lba 0 — phase 0 memory test failed 


The following are normally fatal errors that result in the selftest being aborted. If diagnostic 
error reporting is enabled (switch 7 is ON on CPU board) an attempt is made to send the 


error to the host processor. 


Number 


if 
if 
If 
if 
if 
If 


LED Error Indications 


Test Meaning 


extended instruction trap 
privilege instruction trap 
system call trap 

parity error 

non vectored interrupt 
power fail 


meh wWN eS & 


The ICP’s LEDs can indicate certain failures that may not be able to be reported to the 
CPU’s console. These LED patterns are shown below. Note that in phase | some patterns 
are used twice, once in constant mode to indicate one error, and once in blinking mode to 


indicate another error. 


Phase 0 LED Patterns 


If the test halts prior to completion of phase 0 then the LEDs will not flash. 


Phase | LED Patterns 
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Hex 

Value Meaning 

2 parity error 

a failed sliding bit test or address 
test if diagnostic switch 0 olf 

e hung during parity initialization 

7 hung while verifying parity set 

6 waiting for multibus to unlock 


or got multibus and no device 
to give xack (turn switch 2 olf 
if hung on bus) 

c failed memory test 

{flashing error occurred during phase 0 
(failure written to host proces- 
sor if switch 2 = on) 
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The LED descriptions shown below are true only if DIP switch position 1 (relative to 0 — 
7) is set to ON. 


LED 
Value (hex) | Meaning 


f If on for a while then running selftest with no 
failures or selftest wandered into left field or 
waiting for multibus to unlock to write test 
results (if diagnostic switch 1 ts on) 


f flashing Fatal error occurred during selftest (failure writ- 
ten to host processor if switch 1 is on) 


1,3.4,5.6.a Last phase that failed in LEDs and selftest 
b,c,d,e proceeding or waiting for multibus to unlock if 
switch | is set 


1,3.4,5,6.a Last phase that failed flashing in LEDs and 


b,c,d,e selltest is complete. Error information sent 
blinking to host processor if switch | is set 

9 Error during communication with host processor 
9 blinking Test done and last error was during communica- 


tion with host processor 
NOTE 


If the host system is a z8000 or a 68k processor before 60 
-00100 rev z then diagnostic switch 2 must be set ON. 
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Company Name : 
Your Name (Optional) : 
Manual Name: Plexus P/35 User’s Manual 


Publication Number : 98-05043.6 Rev.A 


Please let us know if anything in this manual is unclear, incomplete, or inaccurate. 


1. Should any information be included or removed? 


iS 


. Please specify the page and nature of any error(s) found in this document. 


3. Other Comments 


Please mail this form to: 


Technical Publications Department 
Plexus Computers, Inc. 

3833 North First St. 

San Jose, CA 95134 


